hurry.resource

Οι πόροι είναι τα αρχεία που χρησιμοποιούνται ως πόροι στην οθόνη μιας ιστοσελίδας, όπως αρχεία CSS, JavaScript αρχεία και εικόνες. Πόροι συσκευάζονται μαζί σε έναν κατάλογο που θα δημοσιευθεί ως τέτοιο ονομάζονται μια βιβλιοθήκη των πόρων.
Όταν ένας πόρος που περιλαμβάνονται στο τμήμα της κεφαλής μιας σελίδας HTML, καλούμε αυτό μια ενσωμάτωση των πόρων. Η εγγραφή αυτή είναι ενός συγκεκριμένου πόρου σε μια συγκεκριμένη βιβλιοθήκη. Υπάρχουν δύο μορφές αυτού του είδους της ένταξης στην HTML: javascript περιλαμβάνεται χρησιμοποιώντας την ετικέτα script, και CSS (και KSS) περιλαμβάνονται, χρησιμοποιώντας μια ετικέτα σύνδεσμο.
Εντάξεις μπορεί να εξαρτάται από άλλα εγκλείσματα. Ένα javascript πόρος μπορεί για παράδειγμα να χτισμένο στην κορυφή του άλλου javascript πόρων. Αυτό σημαίνει ότι οι δυο τους θα πρέπει να φορτώνονται όταν η σελίδα εμφανίζει.
Εξαρτήματα σελίδα μπορεί να απαιτούν πράγματι ένα ορισμένο ένταξης, προκειμένου να είναι λειτουργική. Ένα widget μπορεί, για παράδειγμα, να περιμένετε μια συγκεκριμένη βιβλιοθήκη Javascript για να φορτωθεί. Καλούμε αυτό μια απαίτηση ενσωμάτωση της συνιστώσας.
hurry.resource είναι μια ενότητα που παρέχει ένα απλό API για να καθορίσετε τις βιβλιοθήκες των πόρων, την ένταξη και τις απαιτήσεις ένταξης.
Μια βιβλιοθήκη των πόρων
Ορίζουμε μια foo βιβλιοθήκη. Χρειάζονται δύο επιχειρήματα, το όνομα της βιβλιοθήκης, καθώς θα πρέπει να δημοσιεύονται σύμφωνα με μια διεύθυνση URL και να προσδιορίζουν με μοναδικό τρόπο αυτό, και ένα μονοπάτι προς τη ρίζα των πόρων (rootpath) ότι αυτή η βιβλιοθήκη δημοσιεύει:
>>> Από hurry.resource Βιβλιοθήκη εισαγωγής
>>> Foo = Βιβλιοθήκη ('foo', 'εικονική')
Η πλήρης διαδρομή προς τον κατάλογο με τους πόρους που έχει ανακατασκευαστεί από το πακέτο που η Βιβλιοθήκη ορίζεται σε:
>>> Foo.path #doctest: + ελλειπτικό
«... / Hurry.resource / src / βιασύνη / πόρων / ομοίωμα»
Σημεία Έναρξη
Οι βιβλιοθήκες μπορούν να εκτεθούν για εγγραφή με οποιοδήποτε πλαίσιο ιστοσελίδων που hurry.resource έχει ενσωματωθεί με. Το πλαίσιο αυτό το web μπορεί στη συνέχεια να εκθέσει τη διαδρομή βιβλιοθήκη σε μια διεύθυνση URL κάπου. Αυτό γίνεται με τη χρήση του σημείου εισόδου hurry.resource.libraries. Για να εγγραφείτε Βιβλιοθήκη περιπτώσεις foo και το μπαρ στο πακέτο σας ως σημεία εισόδου περιλαμβάνουν ένα τμήμα, όπως αυτό στο setup.py σας:
entry_points = {
& Nbsp? "Hurry.resource.libraries»: [
& Nbsp? 'Foo = mypackage.foomodule: foo',
& Nbsp? 'Bar = mypackage.barmodule: μπαρ,
& Nbsp?],
& Nbsp?}
Υπάρχει ένα API για να σας βοηθήσει να αποκτήσετε όλα τα εγγεγραμμένα βιβλιοθήκες:
>>> Από hurry.resource βιβλιοθήκες εισαγωγής
Τίποτα δεν είναι εγγεγραμμένος, ωστόσο:
>>> Λίστα (βιβλιοθήκες ())
[]
Θα ήταν ωραίο να έχουμε τώρα μερικές δοκιμές που διαπιστωθεί εάν τα σημεία εισόδου πραγματικά να πάρει έτσι, αλλά αυτό θα απαιτήσει συμμετέχουν διάταξη δοκιμής που βρίσκουμε δύσκολο να κατασκευαστούν.

Τι είναι καινούργιο σε αυτή την έκδοση:

• Η WSGI Middleware εξαρτάται από WebOb, η οποία είναι μια προαιρετική εξάρτηση. Μην εκθέτετε στον __init__.py Ως εκ τούτου, όπως ότι θα πρέπει να είναι ανεξάρτητη από WebOb. Για να χρησιμοποιήσετε την εισαγωγή middleware απευθείας από hurry.resource.wsgi.
• Το εργοστάσιο Βιβλιοθήκη διαθέτει πλέον να ονομάζεται με το επιχείρημα rootpath ως το δεύτερο επιχείρημα. Αυτή είναι μια πορεία προς την πραγματική κατάλογο φυσικών πόρων που αντιπροσωπεύει η βιβλιοθήκη, σε σχέση με τον κατάλογο του πακέτου. Αυτό είναι απαραίτητο για να `` hurry.resource`` χρήσιμο για πλαισίων που δεν βασίζονται σε zope.configuration.
• Αυτή σπάει προς τα πίσω συμβατότητα με προηγούμενες εκδόσεις του hurry.resource? όλος ο κώδικας που χρησιμοποιεί Βιβλιοθήκης θα πρέπει να προσαρμοστεί. Σας παρακαλούμε να ενημερώσετε επίσης setup.py τους να εξαρτάται από hurry.resource & gt?. = 0,10
• Πακέτα πρέπει να εγγραφείτε περιπτώσεις Βιβλιοθήκης τους με hurry.resource χρησιμοποιώντας το σημείο εισόδου hurry.resource.libraries.

Απαιτήσεις :

• Python

Περιορισμοί :

• hurry.resource έχει αντικατασταθεί από το έργο Fanstatic