Produced by Araxis Merge on 3/13/2018 7:48:00 PM Central Daylight Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.
| # | Location | File | Last Modified |
|---|---|---|---|
| 1 | TASCore_v1.0_Build_2_Jan_2018.zip\MCCF_EDI_TAS_WebUI | README.md | Thu Feb 15 20:35:24 2018 UTC |
| 2 | TASCore_v1.0_Build_2_Jan_2018.zip\MCCF_EDI_TAS_WebUI | README.md | Fri Mar 9 17:30:25 2018 UTC |
| Description | Between Files 1 and 2 |
|
|---|---|---|
| Text Blocks | Lines | |
| Unchanged | 3 | 206 |
| Changed | 2 | 4 |
| Inserted | 0 | 0 |
| Removed | 0 | 0 |
| Whitespace | |
|---|---|
| Character case | Differences in character case are significant |
| Line endings | Differences in line endings (CR and LF characters) are ignored |
| CR/LF characters | Not shown in the comparison detail |
No regular expressions were active.
| 1 | # MCCF_TAS _CORE | |
| 2 | ||
| 3 | This proje ct was gen erated wit h [Angular CLI](http s://github .com/angul ar/angular -cli) vers ion 1.0.0- rc.4. | |
| 4 | ||
| 5 | ## Bootstr ap a devel opment env ironment | |
| 6 | ||
| 7 | ### if usi ng a mac | |
| 8 | * use the [laptop sc ript] deve loped by 1 8f | |
| 9 | ```bash | |
| 10 | bash <(cur l -s https ://raw.git hubusercon tent.com/1 8F/laptop/ master/lap top) | |
| 11 | ``` | |
| 12 | ||
| 13 | ### using the Vagran t/ansible setup | |
| 14 | ||
| 15 | 1. Read th rough and perform th e initial setup ment ioned in o ur [MCCF E nv Provisi oning] pro ject | |
| 16 | 1. cd to t his direct ory (home of this gi t project) | |
| 17 | 1. vagrant up | |
| 18 | 1. This wi ll create a virtual machine ca lled dev a nd expose port PORT (an ssh p ort as wel l) | |
| 19 | 1. vagrant ssh (opti onally can specify d ev as the target) | |
| 20 | 1. setup g it so that it does n ot constan tly ask yo u for a pa ssword wit hin the VM (https:// confluence .atlassian .com/bitbu cket/set-u p-ssh-for- git-728138 079.html) | |
| 21 | 1. This is not st rictly nee ded if you use git f rom the ho st, not th e guest | |
| 22 | 1. cd /vag rant | |
| 23 | 1. ansible -galaxy in stall --ro les-path . /roles -r requiremen ts.yml | |
| 24 | 1. this step will query bit bucket and will prom pt you for your user name and p assword se veral time s if you d on't setup git above | |
| 25 | 1. I ty pically do not and j ust use gi t from my host machi ne | |
| 26 | 1. ansible -playbook site.yml | |
| 27 | 1. log out of termin al session , ie `exit ` | |
| 28 | 1. log bac k in, ie ` vagrant ss h` | |
| 29 | 1. you sho uld be abl e to perfo rm the fol lwing comm ands and g et version s | |
| 30 | 1. nvm --version | |
| 31 | 1. node --version | |
| 32 | 1. npm --version | |
| 33 | ||
| 34 | ## Check f or latest Angular ve rsion | |
| 35 | ||
| 36 | ng -v | |
| 37 | // if not >= 1.0.0 r un: | |
| 38 | // npm uni nstall -g @angular/c li | |
| 39 | // npm cac he clean | |
| 40 | // npm ins tall -g @a ngular/cli @latest | |
| 41 | // rm node _modules / / delete n ode_module s director y | |
| 42 | // npm ins tall --sav e-dev @ang ular/cli@l atest | |
| 43 | // npm ins tall | |
| 44 | ||
| 45 | ## Develop ment serve r | |
| 46 | ||
| 47 | Run `npm r un start` for a dev server. Na vigate to `http://lo calhost: PORT /`. The ap p will aut omatically reload if you chang e any of t he source files. | |
| 48 | ||
| 49 | * Pro Tip - open the browser's JavaScrip t console (F12 on Ch rome) to w atch for J avaScript errors whe n running | |
| 50 | ||
| 51 | ## Code sc affolding | |
| 52 | ||
| 53 | Run `ng ge nerate com ponent com ponent-nam e` to gene rate a new component . You can also use ` ng generat e directiv e/pipe/ser vice/class /module`. | |
| 54 | ||
| 55 | ## Build | |
| 56 | ||
| 57 | Run `npm r un build` to build t he project . The buil d artifact s will be stored in the `dist/ ` director y. Use the `-prod` f lag for a production build. | |
| 58 | ||
| 59 | ## Unit Te sting | |
| 60 | To execute Karma uni t tests ru n: `npm te st`. | |
| 61 | ||
| 62 | ## Creatin g a shared Component s | |
| 63 | There are 3 parts to shared co mponents. Modules, w hich are a collectio n of Compo nents and must be de fined firs t. Compone nts, the m ain buildi ng block. And Routes , which al low the ht ml to find the compo nent. | |
| 64 | ||
| 65 | 1. Create a new modu le scafold ing by run ning `ng g module [N ewModuleNa me]` | |
| 66 | 2. In modu le directo ry, create a new Com ponent by running `n g g compon ent [NewCo mponentNam e]` | |
| 67 | 3. Make a module sha red by rep lacing the imported `BrowserMo dule` with `CommonMo dule` insi de module ts file | |
| 68 | 4. Import new module into any desired pa rent modul es (ng see ms to do t his automa tically) | |
| 69 | 5. Add new module an d componen t routes t o their pa rent routi ng arrays | |
| 70 | ||
| 71 | ||
| 72 | ## Creatin g Unit Tes t | |
| 73 | Unfortunat ely Angula r2(1.0.0) is tightly coupled t o Karma's unit test library, s o we need to change some auto generated code to ru n with Moc ha. | |
| 74 | ||
| 75 | * When mak ing unit t ests, name the Mocha test file **[compon ent name]. test.ts** and place all suppor t files in side same directory as compone nt. | |
| 76 | * Mocha sc ripts shou ld not use the arrow function syntax `=> `. [ref](h ttps://moc hajs.org/# arrow-func tions) | |
| 77 | `(myParam) => { myLo cal = myPa ram }` | |
| 78 | should be | |
| 79 | `function( myParam) { myLocal = myParam; }` | |
| 80 | * Import C hai assert ion librar y in test file `impo rt { expec t, assert } from 'ch ai';` | |
| 81 | ||
| 82 | ||
| 83 | ## Running e2e test | |
| 84 | For end-to -end test we need a local HTML server ru nning befo re Protrac tor can ex amine web browser pa ges. Make sure you h ave Java 1 .8 or grea ter instal led. | |
| 85 | ||
| 86 | 1. Open a command co nsole and run `npm r un e2e` to run tests and see r esults | |
| 87 | ||
| 88 | ## e2e wit h Internet Explorer | |
| 89 | [Protracto r IE Setup ](https:// github.com /SeleniumH Q/selenium /wiki/Inte rnetExplor erDriver#r equired-co nfiguratio n) | |
| 90 | ||
| 91 | ## HTML CS S Classes | |
| 92 | [USWDS HTM L template s](https:/ /standards .usa.gov/p age-templa tes/) | |
| 93 | ||
| 94 | ## Configu re with TA S_Backend | |
| 95 | change env iroment.us e_backend = true | |
| 96 | ||
| 97 | run agains t $TAS_Bac kend/$dhag an-1 branc h for now | |
| 98 | ||
| 99 | ## Further help | |
| 100 | ||
| 101 | ||
| 102 | To get mor e help on the Angula r CLI use `ng help` or go chec k out the [Angular C LI README] (https://g ithub.com/ angular/an gular-cli/ blob/maste r/README.m d). | |
| 103 | ||
| 104 | [MCCF Env Provisioni ng]: https ://bitbuck et.org/hal faker/mccf devenvprov isioning | |
| 105 | [laptop sc ript]: htt ps://githu b.com/18F/ laptop |
Araxis Merge (but not the data content of this report) is Copyright © 1993-2016 Araxis Ltd (www.araxis.com). All rights reserved.