Assetgen

Assetgen er tænkt som en erstatning for de forskellige ad hoc-scripts, der ofte bliver skrevet til bygge / styre JavaScript / CSS-filer.
Værktøjet er drevet af den konfiguration, du angiver i en assetgen.yaml fil, f.eks
# Eksempel assetgen.yaml konfiguration
generere:
- js / base.js:
& Nbsp; kilde:
& Nbsp; -% (AMPIFY_ROOT) s / third_party / jslibs / json.js
- Js / app.js:
& Nbsp; kilde:
& nbsp; - statisk / js / Models.coffee
& nbsp; - statisk / js / Views.coffee
& nbsp; - statisk / js / Maps.coffee
& Nbsp; uglify:
& Nbsp; - --define-fra-modul
& Nbsp; - consts
& Nbsp; profile.dev:
& Nbsp; uglify:
& Nbsp; - --define-fra-modul
& Nbsp; - consts-dev
- Gfx / *:
& Nbsp; kilde: statisk / gfx / *
& Nbsp; seværdighed: binær
- Css / site.css:
& Nbsp; kilde:
& Nbsp; - raw: |
& Nbsp; // Public Domain (-) 2011 Den Ampify Forfattere.
& Nbsp; // Se Ampify UNLICENSE fil for detaljer.
& Nbsp; - statisk / css / site.sass
& Nbsp; afhænger:
& Nbsp; -. Statisk / css / * sass
& Nbsp; - statisk / gfx / *
& Nbsp; bidi: true
& Nbsp; embed.path.root: statisk
& Nbsp; embed.url.base: /.static/
prereqs:
- Statisk / js / consts.js:
& Nbsp; kilde: statisk / js / consts.coffee
& Nbsp; komprimeret: falsk
- Statiske / js / consts-dev.js:
& Nbsp; kilde: statisk / js / consts-dev.coffee
& Nbsp; komprimeret: falsk
env:
& nbsp; NODE_PATH.prefix: statiske / js
output.directory: appengine / statisk
output.hashed: true
output.manifest: appengine / assets.json
profile.dev:
& Nbsp; css.compressed: falsk
& Nbsp; js.compressed: falsk
Du kan endda styre, hvilke config muligheder bliver brugt ved at angive --profile parameter. Dette vil tilsidesætte standardværdierne med de værdier, der er specificeret for den givne profil. Så i ovenstående eksempel med angivelse --profile dev vil bruge alle de profile.dev muligheder.
Og endelig kan du angive brugerdefinerede håndterer for assetgen at ringe, når du genererer en fil af en given type. For eksempel, for at tilsidesætte den indbyggede js handleren med én, som bare lavere-sager alt indhold kilden, oprette din udvidelse, f.eks kickass-extension.py:
class KickassAsset (Asset):
& Nbsp; def generere (selv-):
& Nbsp; indhold = '' .join (læs (kilde) .lower () til kilden i self.sources)
& Nbsp; self.emit (self.path, indhold)
register_handler ("js", KickassAsset)
Derefter køre assetgen med --extension sti / til / kickass-extension.py parameter angivet.
Anvendelse
Anvendelse: assetgen [ ...] [options]
Bemærk:
& Nbsp; Hvis du ikke angiver assetgen.yaml filstier, så `git
& Nbsp; LS-filer * assetgen.yaml` vil blive brugt til at opdage alle config
& Nbsp; filer i den aktuelle arkiv. Så du har brug for at være inde
& Nbsp; et git repository arbejdstid træ.
Valg:
& Nbsp; -h, --help vis denne hjælp besked og exit
& Nbsp; -v, --version viser programmets versionsnummer og afslut
& Nbsp; - rene Fjern alt genererede filer
& Nbsp; - debug sæt debug-mode
& Nbsp; - udvidelse = PATH angive en python extension-fil (kan gentages)
& Nbsp; - force force genopbygge af alle filer
& Nbsp; - profil = NAME angive en profil for at bruge
& Nbsp; - watch holde kørende assetgen på en løkke

Funktioner :

• Kompilering CoffeeScript kildefilerne ind JavaScript
• Reducering JavaScript gennem UglifyJS -. Herunder den nye konstant folde support
• Kompilering og Reducering SASS stylesheets i CSS.
• Generering varianter af samme stylesheet for både internationalisering (spejlvende venstre til højre) og til automatisk at indlejre billeder som data:. URI'er at minimere latens
• sammenkæde flere kildefiler til én fil for at minimere antallet af HTTP-anmodninger.
• Oprettelse forskellige filer med hash af indholdet indlejret i filnavnet, så at arbejde effektivt med web caches.
• Oprettelse af en JSON manifest fil til brug i din web app er statiske handlere.

Krav :

• Python