README
french-verbs
Features
Agreement of French verbs, based on a list of verbs.
Use french-verbs-lefff
as a compatible list of verbs.
Contractions are managed: elle s'est marrée, il se gausse, elle s'hydrate, ils se haïssent.
Contains a short static list of verbs that always take "être" auxiliary at past tenses (Passé Composé and Plus Que Parfait).
Installation
npm install french-verbs
Usage
const FrenchVerbs = require('french-verbs');
const Lefff = require('french-verbs-lefff/dist/conjugations.json');
// elle est allée
console.log(
'elle ' + FrenchVerbs.getConjugation(Lefff, 'aller', 'PASSE_COMPOSE', 2, { aux: 'ETRE', agreeGender: 'F' }),
);
// je finis
console.log('je ' + FrenchVerbs.getConjugation(Lefff, 'finir', 'PRESENT', 0));
For conjugations, one single function getConjugation
, with multiple parameters:
verbsList
: list of verbs; usefrench-verbs-lefff
for instance (or anything with the same format)verb
: string, mandatory. Infinitive form of the verb.tense
: string, mandatory. Choose beetwenPRESENT
,FUTUR
,IMPARFAIT
,PASSE_SIMPLE
,CONDITIONNEL_PRESENT
,IMPERATIF_PRESENT
,SUBJONCTIF_PRESENT
,SUBJONCTIF_IMPARFAIT
,PASSE_COMPOSE
,PLUS_QUE_PARFAIT
.person
: number, mandatory. Indicates the person: 0=je, 1=tu, 2=il/elle, 3=nous, 4=vous, 5=ils/elles.- when thense is
PASSE_COMPOSE
orPLUS_QUE_PARFAIT
, a structure with the following properties:aux
: auxiliary,AVOIR
orETRE
. If the auxiliary is not set, these rules will apply:- pronominal verbs always use
ETRE
- there is a short list of verbs that always take
ETRE
- transitive verbs rather take
AVOIR
- pronominal verbs always use
agreeGender
:M
orF
if you want to agree the past participleagreeNumber
:S
orP
if you want to agree the past participle
pronominal
: boolean. Puttrue
to trigger pronominal form. You can alternatively indicate the pronominal form in the verb directly:s'écrier
,se rendre
, etc.
alwaysAuxEtre
returns true
if the verb (passed as an infitive) always conjugates with "être" auxiliary.
isTransitive
returns true
if the verb (passed as an infitive) is transitive.
The agreement is not done automatically even when aux
is ETRE
, as the subject gender is not known.