זוהי הפקודה ocp-indent שניתן להריץ בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות החינמיות שלנו כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS.
תָכְנִית:
שֵׁם
ocp-indent - הזחה אוטומטית של קבצי מקור של OCaml
תַקצִיר
ocp-indent [אוֹפְּצִיָה]... [קובץ] ...
תיאור
הזחת קבצי מקור של OCaml בהתאם למוסכמות הרשמיות, עם מספר קטן של
פרמטרים ניתנים לכוונון.
מפיק את הגרסה המוזחת של כל קובץ שניתן בשורת הפקודה לפלט סטנדרטי,
אלא אם כן מופעל באמצעות האפשרות `--inplace' (ראה אפשרויות אם לא סופק קובץ,
קורא מקלט רגיל.
אפשרויות
-c התצורה, --config=התצורה
הגדר את פרמטרי ההזחה. ראה סעיף תְצוּרָה לקבלת מידע נוסף.
-d, --לנפות
הפעל פלט ניפוי שגיאות ל-stderr.
- עזרה[=FMT] (default=pager)
הצג את העזרה הזו בפורמט FMT (ביפר, רגיל או גרוף).
-i, --במקום
הזחה מחדש של קבצים במקומם.
--כניסה-ריקה
החזרת כניסה גם עבור שורות ריקות. שימושי במיוחד עם $(--numeric).
-l טווח, --שורות=טווח (נעדר=-)
רק להכניס מחדש את השורות ב טווח (למשל 10-12), תוך התאמה לשינוי הנוכחי של
קווים מסביב. קווים מתחילים ב-1.
--load-mods=מדד
טען תוספים.
--load-packs=מדד
טען תוספים.
--מספרי
במקום להכניס מחדש את הקובץ, יש להוציא מספר שלם אחד בכל שורה המייצג את
ערך הזחה. כאשר מצוין יחד עם --שורות, הדפס רק כמה ערכים שאפשר
קווים בטווח.
-o קובץ, --תְפוּקָה=קובץ
פלט אל קובץברירת המחדל היא הדפסה ל-stdout.
--print-config
הדפס את הפרמטרים הנוכחיים ל-stdout וצא. (ראה סעיף תְצוּרָה במשך יותר
מֵידָע.)
--תחביר=מדד
הרחב את התחביר המטופל עבור הרחבות תחביר OCaml.
--גִרְסָה
הצג מידע על גרסה.
תְצוּרָה
ניתן להגדיר פרמטרים בשורת הפקודה באמצעות --config אופציה, או כ-
הגדרת תצורה באחת מהאפשרויות הבאות, חיפוש לפי הסדר: קובץ בשם
`.ocp-indent' בספרייה הנוכחית או בהורים שלה (מה שמאפשר פעולות לפי פרויקט)
הגדרות הזחה), הקובץ `$(HOME)/.ocp/ocp-indent.conf', או הסביבה
משתנה $(OCP_INDENT_CONFIG).
הגדרת תצורה היא רשימה של קישורים בצורה שם = VALUE או של קבוע מראש,
מופרדים באמצעות פסיקים או שורות חדשות
תחביר: [PRESET,]VAR=VALUE[,VAR=VALUE...]
בסיס=INT (ברירת מחדל=2)
הזחה משמשת כאשר אף אחת מהאפשרויות הבאות אינה חלה.
תן פו =
..בָּר
סוג=INT (ברירת מחדל=2)
הזחה עבור הגדרות סוג.
סוג t =
..int
in=INT (ברירת מחדל=0)
הזחה אחרי `let ... in`, אלא אם כן אחריה `let' אחר.
תן foo = () בפנים
..בָּר
עם=INT (ברירת מחדל=0)
הזחה לאחר `match ... with', `try ... with' או `function'.
התאם פו עם
..| _ -> בר
משפט_התאמה=INT (ברירת מחדל=2)
הזחה עבור משפטים בתוך התאמת תבנית (אחרי חצים).
התאם פו עם
| _ ->
..בָּר
ppx_stritem_ext=INT (ברירת מחדל=2)
הזחה עבור פריטים בתוך צומת סיומת [%%id ... ]).
[%% id.id
..יהי x = 3]
max_indent= (ברירת מחדל=4)
בעת קינון ביטויים באותה שורה, הכניסות שלהם מוערמות בחלק מהמקומות
מקרים כך שיישארו נכונים אם תסגור אותם אחד בכל שורה. עם זאת, זה יכול
להוביל לכניסות גדולות בקוד מורכב, כך שפרמטר זה קובע מקסימום
הזחה. שימו לב שזה משפיע רק על הזחה לאחר חיצי הפונקציה והפתיחה
סוגריים בקצות השורות.
יהי f = g (h (i (fun x ->
....x)
)
)
קפדני_עם= (ברירת מחדל = לעולם לא)
אם `never`, קווי ההתאמה מוכנסים פנימה, ומחליפים את `with`, בכל פעם ש-`match with` לא
מתחיל את השורה שלו. אם `auto', ישנם יוצאים מן הכלל עבור מבנים כמו `begin match`
עם'. אם 'תמיד', 'עם' תמיד מכובד בקפדנות.
דוגמה עם `strict_with=לעולם לא,עם=0':
התחל משחק פו עם
..| _ -> בר
סוף
אחר_קפדני= (ברירת מחדל = תמיד)
אם `always', יש להכניס כניסה אחרי מילת המפתח `else' בדרך כלל, כמו אחרי `then'. אם `auto',
כניסה אחרי `else` אלא אם כן ישנן מספר מקרים "בלתי ניתנים לסגירה" (`let .... in', `match' וכו').
אם `never', מילת המפתח `else' לא תזוז כאשר אחריה יובא שורה חדשה.
דוגמה עם `strict_else=המכונית':
אם מצב אז
Foo
אחר
לתת x = עמודה בפנים
באז
הערות_קפדניות=BOOL (ברירת מחדל=שקר)
הזחה בתוך הערות נשמרת בדרך כלל, כל עוד היא מתייחסת לשוליים השמאליים
או שההערות מתחילות בשורה חדשה. הגדרת הערך הזה ל-'true' כופה יישור בתוך
הערות. שורות המתחילות ב-`*` תמיד מיושרות
יישור_אופס=BOOL (ברירת מחדל=אמת)
מחליף העדפה של יישור עמודות על פני הזחת שורות עבור רוב הפונקציות הנפוצות
אופרטורים ואחרי סוגריים פותחים בשורת האמצע.
דוגמה עם `align_ops=נָכוֹן':
יהי fx = x
+ ו
דוגמה עם `align_ops=שקר':
יהי fx = x
+ ו
יישור_פרמטרים= (ברירת מחדל = אוטומטי)
אם `never`, פרמטרי הפונקציה יוזחו רמה אחת משורת הפונקציה.
אם `always', הם מיושרים לפי עמודת הפונקציה. אם `auto', היישור הוא
נבחר על פני הזחה במקרים ספורים, למשל חצים לאחר התאמה
דוגמה עם `align_params=לעולם לא':
התאם פו עם
קצת כיף
..פרמטר
דוגמה עם `align_params=תמיד' או 'המכונית':
התאם פו עם
קצת כיף
..פרמטר
הגדרות קבועות מראש הזמינות הן 'רגיל', ברירת המחדל, 'מתמחה' שעשויה לגרום להיבטים מסוימים של
התחביר ברור יותר למתחילים, ו-`JaneStreet`.
השתמש ב-ocp-indent באופן מקוון באמצעות שירותי onworks.net