Python ROUGE implementation 🦁

FOR EVERY LANGUAGE

This is a wrapper version of Rouge by Google implemented based on HF metrics for every language.

How to use

Requirements

# requirement packages
# pip install -r requirements.txt
git clone https://github.com/m3hrdadfi/rouge-metric .

Load rouge wrapper

from datasets import load_metric

metric = load_metric("./rouge")

Calculate

You just need to enter your language code (ISO code) in the language argument.

references = ["The quick brown fox jumps over the lazy dog"]
predictions = ["The quick black cat jumps over the lazy fox"]
result = metric.compute(predictions=predictions, references=references, language="en")
result = {key: round(value.mid.fmeasure, 4) * 100 for key, value in result.items()}
print(f"Language: English, result: {result}")

Output

Language: English, result: {'rouge1': 77.78, 'rouge2': 50.0, 'rougeL': 66.67, 'rougeLsum': 66.67}

references = ["روباه قهوه‌ای سریع از روی سگ تنبل می‌پرد"]
predictions = ["گربه سیاه سریع از روی روباه تنبل می‌پرد"]
result = metric.compute(predictions=predictions, references=references, language="fa")
result = {key: round(value.mid.fmeasure, 4) * 100 for key, value in result.items()}
print(f"Language: Persian, result: {result}")

Output

Language: Persian, result: {'rouge1': 75.0, 'rouge2': 42.86, 'rougeL': 62.5, 'rougeLsum': 62.5}

How to contribute

Currently, I'm filling the language requirements and probably would complete them shortly. But if you want to help me in this way, you're welcome. You just need to provide the regex and best stemmer package for the language you want or even your native language in an issue or make a pull request as follows.

Fork the repository by clicking on the 'Fork' button on the repository's page. This creates a copy of the code under your GitHub user account.

Clone your fork to your local disk, and add the base repository as a remote:

git clone git@github.com:<your Github handle>/rouge-metric.git
cd rouge-metric
git remote add upstream https://github.com/m3hrdadfi/rouge-metric.git

Set up a development environment by running the following command in a virtual environment:
```
conda create -n env python=3.8 --y
conda activate env
pip install -r requirements.txt 
```
Create a new branch to hold your development changes:
```
git checkout -b a-descriptive-name-for-your-changes-languages
```
Do not work on the master branch.
Develop the features/languages on your branch.
Once you're happy with your implementation, add your changes and make a commit to record your changes locally:
```
git add -A
git commit -m "YOUR MESSAGE"
```
It is a good idea to sync your copy of the code with the original repository regularly. This way you can quickly account for changes:
```
git fetch upstream
git rebase upstream/main
```
Push the changes to your account using:
```
git push -u origin a-descriptive-name-for-your-changes-languages
```
Once you are satisfied, go the webpage of your fork on GitHub. Click on "Pull request" to send your to the project maintainers for review.

License

Apache License 2.0

Languages

Language Name	Language Code	Status
Afar	aa
Abkhazian	ab
Avestan	ae
Afrikaans	af
Akan	ak
Amharic	am
Aragonese	an
Arabic	ar
Assamese	as
Avaric	av
Aymara	ay
Azerbaijani	az
Bashkir	ba
Belarusian	be
Bulgarian	bg
Bihari languages	bh
Bislama	bi
Bambara	bm
Bengali	bn
Tibetan	bo
Breton	br
Bosnian	bs
Catalan; Valencian	ca
Chechen	ce
Chamorro	ch
Corsican	co
Cree	cr
Czech	cs
Church Slavic; Slavonic; Old Bulgarian	cu
Chuvash	cv
Welsh	cy
Danish	da
German	de
Divehi; Dhivehi; Maldivian	dv
Dzongkha	dz
Ewe	ee
Greek, Modern (1453-)	el
English	en	✅
Esperanto	eo
Spanish; Castilian	es
Estonian	et
Basque	eu
Persian	fa	✅
Fulah	ff
Finnish	fi
Fijian	fj
Faroese	fo
French	fr
Western Frisian	fy
Irish	ga	✅
Gaelic; Scottish Gaelic	gd
Galician	gl
Guarani	gn
Gujarati	gu
Manx	gv
Hausa	ha
Hebrew	he
Hindi	hi
Hiri Motu	ho
Croatian	hr
Haitian; Haitian Creole	ht
Hungarian	hu
Armenian	hy
Herero	hz
Interlingua	ia
Indonesian	id
Interlingue; Occidental	ie
Igbo	ig
Sichuan Yi; Nuosu	ii
Inupiaq	ik
Ido	io
Icelandic	is	✅
Italian	it
Inuktitut	iu
Japanese	ja
Javanese	jv
Georgian	ka	✅
Kongo	kg
Kikuyu; Gikuyu	ki
Kuanyama; Kwanyama	kj
Kazakh	kk
Kalaallisut; Greenlandic	kl
Central Khmer	km
Kannada	kn
Korean	ko
Kanuri	kr
Kashmiri	ks
Kurdish	ku
Komi	kv
Cornish	kw
Kirghiz; Kyrgyz	ky
Latin	la
Luxembourgish; Letzeburgesch	lb
Ganda	lg
Limburgan; Limburger; Limburgish	li
Lingala	ln
Lao	lo
Lithuanian	lt	✅
Luba-Katanga	lu
Latvian	lv
Malagasy	mg
Marshallese	mh
Maori	mi
Macedonian	mk
Malayalam	ml
Mongolian	mn
Marathi	mr
Malay	ms
Maltese	mt
Burmese	my
Nauru	na
Norwegian Bokmål	nb
Ndebele, North; North Ndebele	nd
Nepali	ne
Ndonga	ng
Dutch; Flemish	nl
Norwegian Nynorsk	nn
Norwegian	no
Ndebele, South; South Ndebele	nr
Navajo; Navaho	nv
Chichewa; Chewa; Nyanja	ny
Occitan (post 1500)	oc
Ojibwa	oj
Oromo	om
Oriya	or
Ossetian; Ossetic	os
Panjabi; Punjabi	pa
Pali	pi
Polish	pl
Pushto; Pashto	ps
Portuguese	pt
Quechua	qu
Romansh	rm
Rundi	rn
Romanian; Moldavian; Moldovan	ro
Russian	ru
Kinyarwanda	rw
Sanskrit	sa
Sardinian	sc
Sindhi	sd
Northern Sami	se
Sango	sg
Sinhala; Sinhalese	si
Slovak	sk
Slovenian	sl
Samoan	sm
Shona	sn
Somali	so
Albanian	sq
Serbian	sr
Swati	ss
Sotho, Southern	st
Sundanese	su
Swedish	sv
Swahili	sw
Tamil	ta
Telugu	te
Tajik	tg
Thai	th
Tigrinya	ti
Turkmen	tk
Tagalog	tl
Tswana	tn
Tonga (Tonga Islands)	to
Turkish	tr	✅
Tsonga	ts
Tatar	tt
Twi	tw
Tahitian	ty
Uighur; Uyghur	ug
Ukrainian	uk
Urdu	ur
Uzbek	uz
Venda	ve
Vietnamese	vi
Volapük	vo
Walloon	wa
Wolof	wo
Xhosa	xh
Yiddish	yi
Yoruba	yo
Zhuang; Chuang	za
Chinese	zh
Zulu	zu