js_of_eliom - מקוון בענן

תָכְנִית:

שֵׁם

eliomc, eliomcp, eliomopt, js_of_eliom, eliomdep - הכלים לבניית eliom

תַקצִיר

eliomc [אפשרויות] קבצים

eliomcp [אפשרויות] קבצים

אליומפט [אפשרויות] קבצים

eliomdep [אפשרויות] קבצים

eliomdoc [אפשרויות] קבצים

eliompp [-לָקוּחַ|-שרת] קבצים

js_of_eliom [אפשרויות] קבצים -o filename.js

תיאור

eliomc, eliomcp ו אליומפט הם עוטפים את מהדר ה-OCaml שמקלים על
קומפילציה של חלק השרת של פרויקטים על בסיס מסגרת Eliom. הם בהתאמה
קבל את אותה קבוצת אפשרויות מאשר ה- ocamlc(1),ocamlcp(1) ו ocamlopt(1) מהדרים פלוס
הספציפיים המתוארים ב- אפשרויות סָעִיף.

js_of_eliom הוא מעטפת סביב מהדרים Ocaml ו-Js_of_ocaml המקלים על
הידור חלק הלקוח בפרויקטים על בסיס מסגרת Eliom. זה מקבל את
אותה סט של אפשרויות מאשר ה ocamlc(1) מהדר בתוספת אלה הספציפיים המתוארים ב
אפשרויות סָעִיף.

eliomdep הוא עטיפה מסביב ocamldep(1) המטפל בתלות של מקור .eliom
קבצים. הוא מקבל את אותה סט של אפשרויות בתוספת הספציפיות המתוארות ב אפשרויות
סָעִיף. זה עושה את ההנחה שממוקמים בצד השרת מודולים של קבצי OCaml
בספרייה זו תת-עץ נמצאים בספרייה _שרת (עם אותו מבנה ספריות משנה)
(בהתאמה בספרייה _לקוחות עבור מודולים מהודרים בצד הלקוח).

eliompp (נִסיוֹנִי) הוא מעבד קדם אשר מסיר חלקים ספציפיים, בהתאם ל
אפשרות שניתנה. האפשרות -לָקוּחַ יסיר את כל החלקים וחלקי השרת ברמה העליונה
והאופציה -שרת יסיר רק את חלקי הלקוח.

eliomdoc (נִסיוֹנִי) הוא עטיפה סביב מחולל התיעוד של Ocaml ocamldoc.
זה מאפשר לך ליצור תיעוד מ לקוחות or שרת צַד. זה מקבל אותו דבר
סט של אפשרויות מאשר ocamldoc(1). זה מחלץ אוטומטית את הפרשנויות מה-
קטעים רצויים. eliomdoc כרגע הוא ניסיוני, ואתה יכול למצוא חלק לא מוגדר
התנהגויות. (לִרְאוֹת http://ocsigen.org/eliom/manual/workflow-compilation). חלקם ידועים
באגים הם:

· הקבצים שלך תמיד צריכים להתחיל בערך ולא בהערה. אחרת,
camlp4 לא יוציא את הפרשנויות.

· לפעמים, צומת הערות אינו מצורף כצפוי. זה בגלל camlp4
(לפעמים) הסר קו חדש נוסף בין רכיבי ערך.

קומפילציה ELIOM מקור קבצים

הידור של קבצים עם סיומת eliom מושגת בשלושה שלבים: להסיק את
סוג הערך שנשלח על ידי השרת ללקוח; קומפיל את חלק השרת של הקוד ו
להרכיב את חלק הלקוח. ניתן לממש את שני השלבים הראשונים עם eliomc והאחרון
עם js_of_eliom.

שני הכלים מייצרים קובץ .cmo בשם קובץ .eliom המקורי. כדי למנוע החלפת ה-
.cmo המייצג את חלק השרת עם .cmo של חלק הלקוח, קבצים שנוצרו על ידי
eliomc or אליומפט מאוחסנים כברירת מחדל בספריית משנה בשם _server וקבצים
נוצר באמצעות js_of_eliom מאוחסנים בספריית משנה בשם _client. ברירת המחדל האלה
ניתן לעקוף ספריות בהתאמה על ידי משתני הסביבה ELIOM_SERVER_DIR
ו- ELIOM_CLIENT_DIR.

הסוגים המתקבלים על ידי eliomc עבור ערכים שנשלחו על ידי השרת ללקוח מאוחסנים ב-an
קבצי ביניים המכונים כקובץ eliom המקורי והסיומת שלהם היא .type_mli.
הקובץ הזה נדרש על ידי js_of_eliom עבור קומפילציה של חלק הלקוח של קובץ eliom. ה
eliomdep כלי ליצור כראוי תלות קובץ ביניים עבור השרת .cmo
והלקוח .cmo.

אפשרויות

-eliom-inc לְהוֹסִיף לרשימת eliom כוללים ספריות (eliomdep בלבד).

-די
ציין את ספריית היעד עבור קבצים שנוצרו

-חֲבִילָה
זו אותה אפשרות לזו של ocamlfind.

-פרדיקטים
זו אותה אפשרות לזו של ocamlfind.

-ללא טעינה אוטומטית
אל תטען הרחבות תחביר בשימוש נפוץ (נגזרת, lwt, js_of_ocaml, tyxml).

-type-conv
השתמש בתוספי תחביר type_conv במקום לגזור אחד. אין לזה השפעה אם משתמשים בו
בשילוב עם -no-autoload.

-ppopt
לְצַרֵף להזמנת קדם-מעבד.

-jsopt
לְצַרֵף ל-js_of_ocaml invocation (js_of_eliom בלבד).

-לְהַסִיק
עבור קובץ eliom, צור רק את קובץ הביניים .type_mli (eliomc ו- eliomopt
רק).

-לא להסיק
עבור קובץ eliom, אל תיצור את קובץ הביניים .type_mli (eliomc ו-
אליומופט בלבד).

עזרה or - עזרה
הצג סיכום שימוש קצר וצא.

דוגמאות

הידור של פרויקטים של Eliom המורכב מקובץ ספציפי לשרת בשם server.ml, א
קובץ ספציפי ללקוח בשם client.ml ושני קבצים נפוצים בשם base.eliom ו-main.eliom,
ניתן להשיג באמצעות הפקודות הבאות:

eliomc -a -o appl.cma server.ml base.eliom main.eliom
js_of_eliom -o appl.js client.ml base.eliom main.eliom

כדי להימנע מהידור מחדש של כל הפרויקט בכל פעם, ניתן לפצל את זה במספר שלבים:

eliomc -c server.ml
eliomc -c base.eliom
eliomc -c main.eliom
eliomc -a -o appl.cma _server/server.cmo _server/base.cmo _server/main.cmo
js_of_eliom -c client.ml
js_of_eliom -c base.eliom
js_of_eliom -c main.eliom
js_of_eliom -o appl.js _client/client.cmo _client/base.cmo _client/main.cmo

השתמש ב-js_of_eliom באינטרנט באמצעות שירותי onworks.net