hurry.resource

Les ressources sont des fichiers qui sont utilisés comme des ressources dans l'affichage d'une page Web, tels que les fichiers CSS, JavaScript et fichiers images. Ressources emballés ensemble dans un répertoire pour être publiées en tant que telles sont appelés une bibliothèque de ressources.
Lorsqu'une ressource est incluse dans la section de la tête d'une page HTML, nous appelons cela une inclusion des ressources. Une inclusion est d'une ressource particulière dans une bibliothèque particulière. Il existe deux formes de ce type d'inclusion dans HTML: javascript est inclus en utilisant la balise de script, et CSS (KSS) sont inclus en utilisant une balise de lien.
Inclusions peuvent dépendre d'autres inclusions. Une ressource javascript peut par exemple être construit au-dessus d'une autre ressource javascript. Cela signifie à la fois d'entre eux devraient être chargés lorsque la page affiche.
Page composants peuvent effectivement besoin d'une certaine intégration afin d'être fonctionnel. Un widget peut par exemple s'attendre à une bibliothèque Javascript notamment chargé. Nous appelons cela une exigence de l'inclusion de la composante.
hurry.resource est un module qui fournit une API simple pour spécifier des bibliothèques de ressources, l'inclusion et les exigences d'inclusion.
Une bibliothèque de ressources
Nous définissons une foo de la bibliothèque. Elle prend deux arguments, le nom de la bibliothèque comme elle devrait être publiée en vertu d'une URL et identifier de manière unique, et un chemin d'accès à la racine des ressources (rootPath) que cette bibliothèque publie:
>>> De la bibliothèque d'importation de hurry.resource
>>> Foo = Library ('foo', «factice»)
Le chemin complet vers le répertoire avec les ressources est reconstruite à partir du paquet que la Bibliothèque est défini dans:
>>> Foo.path #doctest: + ELLIPSIS
»... / Hurry.resource / src / pressé / resource / factice»
Les points Entrée
Les bibliothèques peuvent être exposés à l'enregistrement par quelque framework web que hurry.resource est intégré avec. Ce framework web peut alors exposer le chemin de la bibliothèque sur une URL quelque part. Ceci est fait en utilisant le point d'entrée hurry.resource.libraries. Pour vous inscrire instances Bibliothèque foo et bar dans votre forfait comme points d'entrée comprennent une section de ce type dans votre setup.py:
entry_points = {
& Nbsp; »hurry.resource.libraries ': [
& Nbsp; 'foo = mypackage.foomodule: foo',
& Nbsp; »bar = mypackage.barmodule: bar ',
& Nbsp;],
& Nbsp;}
Il est une API pour vous aider à obtenir toutes les bibliothèques enregistrés:
>>> À partir de bibliothèques d'importation hurry.resource
Rien est cependant enregistré:
>>> liste (bibliothèques ())
[]
Il serait agréable d'avoir maintenant des tests qui voient si les points d'entrée effectivement obtenir ramassé donc, mais qui nécessiterait une configuration de test impliqués que nous trouvons difficile de construire.

Ce qui est nouveau dans cette version:

• Le WSGI Middleware dépend WebOb, qui est une dépendance optionnelle. Ne pas l'exposer dans le __init__.py donc, comme cela doit être indépendant de WebOb. Pour utiliser l'importation de middleware directement à partir hurry.resource.wsgi.
• L'usine de bibliothèque doit maintenant être appelé avec un argument de cheminracine comme second argument. Ceci est un chemin vers le répertoire réelle des ressources que la bibliothèque représente, par rapport au répertoire de l'emballage. Cela est nécessaire pour faire des `` hurry.resource`` utile pour les cadres ne repose pas sur zope.configuration.
• Cela rompt la compatibilité ascendante avec les versions précédentes de hurry.resource; tout le code qui utilise la bibliothèque doit être ajustée. S'il vous plaît mettre à jour aussi leur setup.py dépendre hurry.resource & gt;. = 0,10
• Les emballages doivent enregistrer leurs instances bibliothèque hurry.resource utilisant le point hurry.resource.libraries d'entrée.

Exigences :

• Python

Limitations :

• hurry.resource a été remplacé par le projet Fantastique