README

HAL, the French open archive, for omniscient/omnischolar: an author's deposits - by idHAL, ORCID or the name they sign - with their full texts in open access; a deposit by its HAL id, DOI or arXiv id; a search; and on every query a filter by domain: shs.droit is the legal scholarship (doctrine) HAL holds. No key.

$hal = (new HalSourceFactory($http))->create();
$hal->works('Keitaro Nakatani');                                         // the deposits signed so
$hal->works('remi-metivier');                                            // by idHAL
$droit = (new HalSourceFactory($http))->create(['domains' => ['shs.droit']]);
$droit->search(new Query(text: 'responsabilité civile', from: 2024));

omnischolar:
    sources:
        hal: { factory: hal }
        droit: { factory: hal, options: { domains: [shs.droit] } }   # every query filtered on that domain

See docs/.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by the CCSD (HAL) or its supervising bodies (CNRS, Inria, INRAE). It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with HAL's terms (CGU of the HAL portals), for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.

omnischolar / hal

Package info

Security

Statistics

README

Responsibility