hurry.resource

Le risorse sono file che vengono utilizzati come risorse nella visualizzazione di una pagina web, come file CSS, file Javascript e immagini. Risorse confezionati insieme in una directory che sarà pubblicato in quanto tali sono chiamati una libreria di risorse.
Quando una risorsa è inclusa nella sezione head di una pagina HTML, chiamiamo questo un'inclusione risorsa. Una inclusione è di una particolare risorsa in una particolare libreria. Ci sono due forme di questo tipo di inclusione in HTML: javascript è inclusa con il tag script, e CSS (e KSS) sono inclusi con un tag link.
Inclusioni possono dipendere da altri inclusioni. Una risorsa javascript può ad esempio essere costruito sulla base di un altro javascript risorsa. Ciò significa che ciascuno di essi dovrebbero essere caricati quando la pagina viene visualizzata.
Componenti Page possibile che richiedano un certo inclusione per essere funzionale. Un widget può ad esempio aspettare una particolare libreria Javascript per caricato. Chiamiamo questo un requisito inclusione del componente.
hurry.resource è un modulo che fornisce una semplice API per specificare le librerie di risorse, l'inclusione e requisiti di inclusione.
Una libreria di risorse
Definiamo una foo biblioteca. Ci vogliono due argomenti, il nome della libreria come dovrebbe essere pubblicato sotto in un URL e identificare in modo univoco, e un percorso alla radice delle risorse (RootPath) che questa biblioteca pubblica le:
>>> Da hurry.resource libreria di importazione
>>> Foo = Library ('foo', 'manichino')
Il percorso completo della directory con le risorse viene ricostruito dal pacchetto che la Biblioteca è definita in:
>>> Foo.path #doctest: + ELLIPSIS
'... / Hurry.resource / src / fretta / risorsa / manichino'
Punti ingresso
Le biblioteche possono essere esposti per la registrazione con qualsiasi framework web che hurry.resource è integrato con. Questo framework web può quindi esporre il percorso di libreria su un URL da qualche parte. Questo viene fatto utilizzando il punto hurry.resource.libraries ingresso. Per registrare le istanze Biblioteca foo e bar nel pacchetto come punti di ingresso comprendono una sezione simile nel setup.py:
entry_points = {
& Nbsp; 'hurry.resource.libraries': [
& Nbsp; 'foo = mypackage.foomodule: foo',
& Nbsp; 'bar = mypackage.barmodule: bar',
& Nbsp;],
& Nbsp;}
Vi è una API per aiutarvi a ottenere tutte le librerie registrati:
>>> Da librerie di importazione hurry.resource
Nulla è registrato però:
Lista >>> (librerie ())
[]
Sarebbe bello avere ora alcuni test che vedono se i punti di ingresso effettivamente ottenere raccolti in modo, ma che richiederebbe una messa a punto di test coinvolti che troviamo difficile da costruire.

Cosa c'è di nuovo in questa versione:

• Il WSGI Middleware dipende WebOb, che è una dipendenza opzionale. Non esporre nel __init__.py quindi, come che deve essere indipendente da WebOb. Per utilizzare il middleware importazione direttamente dal hurry.resource.wsgi.
• La fabbrica Biblioteca ha ora di essere chiamato con un argomento ROOTPATH ​​come secondo argomento. Questo è un percorso alla directory risorsa reale che la biblioteca rappresenta, relativamente alla directory del pacchetto. Ciò è necessario per fare `` hurry.resource`` utile per i quadri non si basa sul zope.configuration.
• Questo rompe la compatibilità con le versioni precedenti di hurry.resource; tutto il codice che utilizza Biblioteca deve essere regolata. Si prega di aggiornare anche il loro setup.py dipendere hurry.resource & gt;. = 0.10
• I pacchetti dovrebbero registrare le proprie istanze Biblioteca con hurry.resource utilizzando il punto hurry.resource.libraries ingresso.

Requisiti

• Python

Limitazioni :

• hurry.resource è stata sostituita dal progetto fanstatic