Security News
Cloudflare Adds Security.txt Setup Wizard
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
@hebcal/leyning
Advanced tools
Javascript Torah Reading API for Parashat HaShavua and holidays
$ npm install @hebcal/leyning
import {HebrewCalendar, HDate, Event} from '@hebcal/core';
import {getLeyningForParshaHaShavua, getTriennialForParshaHaShavua,
formatAliyahWithBook} from '@hebcal/leyning';
const events = HebrewCalendar.calendar({sedrot: true, noHolidays: true});
const ev = events.find((ev) => ev.getDesc() == 'Parashat Pinchas');
const reading = getLeyningForParshaHaShavua(ev);
console.log(`${ev.getDesc()}: ${reading.summary}`);
console.log(`Haftara: ${reading.haftara}`);
for (const [num, aliyah] of Object.entries(reading.fullkriyah)) {
const number = num == 'M' ? 'maftir' : `aliyah ${num}`;
let str = formatAliyahWithBook(aliyah);
if (reading.reason[num]) {
str += ' | ' + reading.reason[num];
}
str += ` (${aliyah.v} verses)`;
console.log(`${number}: ${str}`);
}
const triReading = getTriennialForParshaHaShavua(ev);
for (const [num, aliyah] of Object.entries(triReading)) {
const number = num == 'M' ? 'maftir' : `aliyah ${num}`;
const str = formatAliyahWithBook(aliyah);
console.log(`Triennial ${number}: ${str}`);
}
Triennial Torah readings
Names of the books of the Torah. BOOK[1] === 'Genesis'
Makes Sefaria links by adding href
, verses
and num
attributes to each aliyah.
CAUTION: Modifies the aliyot
parameter instead of making a copy.
string
Based on the event date, type and title, finds the relevant leyning key
Leyning
Looks up leyning for a given holiday. Returns some of full kriyah aliyot, special Maftir, special Haftarah
string
Makes a summary of the leyning, like "Genesis 6:9-11:32"
Leyning
Looks up leyning for a given holiday key. Key should be an (untranslated) string used in holiday-readings.json. Returns some of full kriyah aliyot, special Maftir, special Haftarah
Leyning
Looks up regular leyning for a weekly parsha with no special readings
Leyning
Looks up leyning for a regular Shabbat parsha.
string
Formats an aliyah object like "Numbers 28:9-28:15"
string
Formats an aliyah object like "Numbers 28:9-15"
Triennial
Calculates the 3-year readings for a given year
TriennialAliyot
| Object.<string, Aliyah>
Looks up the triennial leyning for this Parashat HaShavua
Object
Represents an aliyah
Object
Leyning for a parsha hashavua or holiday
Object
Represents triennial aliyot for a given date
Triennial Torah readings
Kind: global class
Object.<string, Aliyah>
number
string
number
number
Builds a Triennial object
Param | Type | Description |
---|---|---|
[hebrewYear] | number | Hebrew Year (default current year) |
Object.<string, Aliyah>
Kind: instance method of Triennial
Returns: Object.<string, Aliyah>
- a map of aliyot 1-7 plus "M"
Param | Type | Description |
---|---|---|
parsha | string | parsha name ("Bereshit" or "Achrei Mot-Kedoshim") |
yearNum | number | 0 through 2 for which year of Triennial cycle |
number
Kind: instance method of Triennial
string
Kind: instance method of Triennial
number
Returns triennial year 1, 2 or 3 based on this Hebrew year
Kind: static method of Triennial
Param | Type | Description |
---|---|---|
year | number | Hebrew year |
number
Returns Hebrew year that this 3-year triennial cycle began
Kind: static method of Triennial
Param | Type | Description |
---|---|---|
year | number | Hebrew year |
Names of the books of the Torah. BOOK[1] === 'Genesis'
Deprecated
Makes Sefaria links by adding href
, verses
and num
attributes to each aliyah.
CAUTION: Modifies the aliyot
parameter instead of making a copy.
Kind: global function
Param | Type | Description |
---|---|---|
aliyot | Object.<string, Aliyah> | aliyah map to decorate |
showBook | boolean | display the book name in the verses field (e.g. for special Maftir) |
string
Based on the event date, type and title, finds the relevant leyning key
Kind: global function
Returns: string
- key to look up in holiday-reading.json
Param | Type | Default | Description |
---|---|---|---|
e | Event | event | |
[il] | boolean | false | true if Israel holiday scheme |
Leyning
Looks up leyning for a given holiday. Returns some of full kriyah aliyot, special Maftir, special Haftarah
Kind: global function
Returns: Leyning
- map of aliyot
Param | Type | Default | Description |
---|---|---|---|
e | Event | the Hebcal event associated with this leyning | |
[il] | boolean | false | true if Israel holiday scheme |
string
Makes a summary of the leyning, like "Genesis 6:9-11:32"
Kind: global function
Param | Type |
---|---|
aliyot | Object.<string, Aliyah> |
Leyning
Looks up leyning for a given holiday key. Key should be an (untranslated) string used in holiday-readings.json. Returns some of full kriyah aliyot, special Maftir, special Haftarah
Kind: global function
Returns: Leyning
- map of aliyot
Param | Type | Description |
---|---|---|
key | string | name from holiday-readings.json to find |
Leyning
Looks up regular leyning for a weekly parsha with no special readings
Kind: global function
Returns: Leyning
- map of aliyot
Param | Type | Description |
---|---|---|
parsha | string | Array.<string> | untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei'] |
Leyning
Kind: inner constant of getLeyningForParsha
Leyning
Looks up leyning for a regular Shabbat parsha.
Kind: global function
Returns: Leyning
- map of aliyot
Param | Type | Default | Description |
---|---|---|---|
ev | Event | the Hebcal event associated with this leyning | |
[il] | boolean | false | in Israel |
string
Formats an aliyah object like "Numbers 28:9-28:15"
Kind: global function
Param | Type | Description |
---|---|---|
a | Aliyah | aliyah |
string
Formats an aliyah object like "Numbers 28:9-15"
Kind: global function
Param | Type |
---|---|
aliyah | Aliyah |
showBook | boolean |
Triennial
Calculates the 3-year readings for a given year
Kind: global function
Param | Type | Description |
---|---|---|
year | number | Hebrew year |
TriennialAliyot
| Object.<string, Aliyah>
Looks up the triennial leyning for this Parashat HaShavua
Kind: global function
Returns: TriennialAliyot
| Object.<string, Aliyah>
- a map of aliyot 1-7 plus "M"
Param | Type | Default | Description |
---|---|---|---|
ev | Event | ||
[context] | boolean | false | returns a reading wrapper object which includes date , yearNum and aliyot |
Object
Represents an aliyah
Kind: global typedef
Properties
Name | Type | Description |
---|---|---|
k | string | Book (e.g. "Numbers") |
b | string | beginning verse (e.g. "28:9") |
e | string | ending verse (e.g. "28:15") |
[v] | number | number of verses |
[p] | number | parsha number (1=Bereshit, 54=Vezot HaBracha) |
Object
Leyning for a parsha hashavua or holiday
Kind: global typedef
Properties
Name | Type | Description |
---|---|---|
summary | string | |
haft | Aliyah | Haftarah |
haftara | string | Haftarah |
[haftaraNumV] | number | |
[seph] | Aliyah | Haftarah for Sephardic |
[sephardic] | string | Haftarah for Sephardic |
[sephardicNumV] | number | |
fullkriyah | Object.<string, Aliyah> | |
[weekday] | Object.<string, Aliyah> | |
[reason] | Object |
Object
Represents triennial aliyot for a given date
Kind: global typedef
Properties
Name | Type | Description |
---|---|---|
aliyot | Object.<string, Aliyah> | a map of aliyot 1-7 plus "M" |
yearNum | number | year number, 0-2 |
date | Date | Shabbat date for when this parsha is read in this 3-year cycle |
[readSeparately] | boolean | true if a double parsha is read separately in year yearNum |
[date1] | Date | Shabbat date of the first part of a read-separately aliyah pair |
[date2] | Date | Shabbat date of the second part of a read-separately aliyah pair |
FAQs
Torah Reading API for Parashat HaShavua and holidays
We found that @hebcal/leyning demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
Security News
The Socket Research team breaks down a malicious npm package targeting the legitimate DOMPurify library. It uses obfuscated code to hide that it is exfiltrating browser and crypto wallet data.
Security News
ENISA’s 2024 report highlights the EU’s top cybersecurity threats, including rising DDoS attacks, ransomware, supply chain vulnerabilities, and weaponized AI.