JIRA: USDU-170 Add Formatting and API file generation. (#250)

* Add the coding standard package.

* Fix the test project: leftover from previous PR

* Massive Reformat and API file generation.

* USD.NET reformat and API generation

Co-authored-by: Julien Dubuisson <[email protected]>

Author: clusty

.editorconfig

@@ -1,67 +1,64 @@
-# see http://editorconfig.org/ for docs on this file
+; see http://editorconfig.org/ for docs on this file
 
 root = true
 
 [*]
-# help with sharing files across os's (i.e. network share or through local vm)
-end_of_line = lf
+ignore_if_in_header = This code was generated by a tool|<auto-generated>
+indent_style = space
+indent_size = 4
+; uncomment to help with sharing files across os's (i.e. network share or through local vm)
+#end_of_line = lf
+; avoid a bom, which causes endless problems with naive text tooling
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
+; keeping auto-format enabled helps avoid merge hell for projects without CI-based format validation
+#disable_auto_format = true
 
-# formattable file extensions (keep in sync with format.ini from unity-meta repo)
-#
-# Note: We need to split the formattable files configs into shorter duplicate entries (logically grouped)
-# due to known issue in VS editorconfig extension where there is a limit of 51 characters (empirically determined).
-# see: https://github.com/editorconfig/editorconfig-visualstudio/issues/21
-#
-## uncrustify
-[*.{c,h,cpp,hpp,m,mm,cc,cs}]
-indent_style = space
-indent_size = 4
+[*.cs]
+; uncomment to enable full formatting of c# files
+formatters = generic, uncrustify
 
-## generic formatter (shaders)
-[*.{cg,cginc,glslinc,hlsl,shader,y,ypp,yy}]
-indent_style = space
-indent_size = 4
+[*.asmdef]
+scrape_api = true
 
-## generic formatter (misc)
-[*.{asm,s,S,pch,pchmm,java,sh,uss}]
-indent_style = space
-indent_size = 4
+[**/Tests/**.asmdef]
+scrape_api = false
 
-## perltidy
-[*.{pl,pm,t,it}]
-indent_style = space
-indent_size = 4
+[*.Tests.asmdef]
+scrape_api = false
 
-## unity special
-[*.{bindings,mem.xml}]
-indent_style = space
-indent_size = 4
+[*.md]
+indent_size = 2
+; trailing whitespace is unfortunately significant in markdown
+trim_trailing_whitespace = false
+; uncomment to enable basic formatting of markdown files
+#formatters = generic
 
-# other filetypes we want to overwrite default configuration to preserve the standard
 [{Makefile,makefile}]
-# TAB characters are part of the Makefile format
+; tab characters are part of the Makefile format
 indent_style = tab
 
-[*.{md,markdown}]
-# trailing whitespace is significant in markdown (bad choice, bad!)
-trim_trailing_whitespace = false
+[*.asmdef]
+indent_size = 4
 
-[*.{json,asmdef}]
-indent_style = space
-# seems to be more common
+[*.json]
 indent_size = 2
 
-# keep these and the VS stuff below in sync with .hgeol's CRLF extensions
 [*.{vcproj,bat,cmd,xaml,tt,t4,ttinclude}]
 end_of_line = crlf
 
-# this VS-specific stuff is based on experiments to see how VS will modify a file after it has been manually edited.
-# the settings are meant to closely match what VS does to minimize unnecessary diffs. this duplicates some settings in *
-# but let's be explicit here to be safe (in case someone wants to copy-paste this out to another .editorconfig).
-[*.{vcxproj,vcxproj.filters,csproj,props,targets}]
+; this VS-specific stuff is based on experiments to see how VS will modify a file after it has been manually edited.
+; the settings are meant to closely match what VS does to minimize unnecessary diffs.
+[*.{vcxproj,vcxproj.filters}]
+indent_style = space
+indent_size = 2
+end_of_line = crlf
+charset = utf-8-bom
+trim_trailing_whitespace = true
+insert_final_newline = false
+; must be broken out because of 51-char bug (https://github.com/editorconfig/editorconfig-visualstudio/issues/21)
+[*.{csproj,pyproj,props,targets}]
 indent_style = space
 indent_size = 2
 end_of_line = crlf
@@ -72,5 +69,6 @@ insert_final_newline = false
 indent_style = tab
 indent_size = 4
 end_of_line = crlf
+charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = false

.gitattributes

@@ -0,0 +1,22 @@
+* text=auto eol=lf
+
+# match .editorconfig
+
+*.vcproj eol=crlf
+*.bat eol=crlf
+*.cmd eol=crlf
+*.xaml eol=crlf
+*.tt eol=crlf
+*.t4 eol=crlf
+*.ttinclude eol=crlf
+
+*.vcxproj eol=crlf
+*.vcxproj.filters eol=crlf
+
+*.csproj eol=crlf
+*.pyproj eol=crlf
+*.props eol=crlf
+*.targets eol=crlf
+
+*.sln eol=crlf
+*.sln.template eol=crlf

.gitignore

@@ -71,4 +71,5 @@ TestProject/**/Temp
 TestProject/**/Logs
 TestProject/**/*.csproj
 TestProject/**/*.sln
+TestProject/Usd-Development/Library
 build_usdcs

package/com.unity.formats.usd/Runtime/Plugins/x86_64/Windows/cmake.meta renamed to TestProject/Usd-Development/Assets/Resources.meta

@@ -1,5 +1,6 @@
 {
   "dependencies": {
+    "com.unity.coding": "0.1.0-preview.20",
     "com.unity.analytics": "3.3.5",
     "com.unity.ext.nunit": "1.0.0",
     "com.unity.formats.usd": "file:../../../package/com.unity.formats.usd/",