Home Explore Help
Sign In
c
/
gravity-lang
mirror of https://github.com/marcobambini/gravity.git
2
0
Fork 0
Files Issues 0 Wiki
Tree: 45f6192cb1
Branches Tags
gravity-lang
/
docs
/
internals
/
1_files.html

1_files.html 12 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175 
  1. <!DOCTYPE html>
    2. 

  2. <html>
    3. 

  3.   <head>
    4. 

  4.     <meta charset="utf-8">
    5. 

  5.     <meta name="viewport" content="width=device-width, initial-scale=1">
    6. 

  6.     <title>Gravity: Files</title>
    7. 

  7.     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/normalize/5.0.0/normalize.min.css" />
    8. 

  8.     <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
    9. 

  9.     <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700,800">
    10. 

  10.     <link rel="stylesheet" href="../scripts/highlight/styles/github-gist.css">
    11. 

  11.     <link rel="stylesheet" href="../stylesheets/styles.css">
    12. 

  12.     <script src="https://use.fontawesome.com/2e9ff283e5.js"></script>
    13. 

  13.   </head>
    14. 

  14.   <body>
    15. 

  15. 

  16. 	<!-- BEGIN NAVIGATION BAR -->
    17. 

  17. 	<nav class="navbar navbar-default navbar-fixed-top">
    18. 

  18. 		<div class="container">
    19. 

  19. 		<div class="navbar-header">
    20. 

  20. 			<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
    21. 

  21. 				<span class="sr-only">Toggle navigation</span>
    22. 

  22. 				<span class="icon-bar"></span>
    23. 

  23. 				<span class="icon-bar"></span>
    24. 

  24. 				<span class="icon-bar"></span>
    25. 

  25. 			</button>
    26. 

  26. 			<a class="navbar-brand" href="http://gravity-lang.org"><img src="../images/logo.png" width="32px" height="36px"></a>
    27. 

  27. 		</div>
    28. 

  28. 		<div id="navbar" class="navbar-collapse collapse">
    29. 

  29. 			<ul class="nav navbar-nav navbar-right">
    30. 

  30. 				<li><a href="../index.html">Gravity</a></li>
    31. 

  31. 				<li class="active"><a href="index.html">Internals</a></li>
    32. 

  32. 				<li><a href="https://github.com/marcobambini/gravity">GitHub</a></li>
    33. 

  33. 			</ul>
    34. 

  34. 		</div><!--/.nav-collapse -->
    35. 

  35. 	</div>
    36. 

  36. 	</nav>
    37. 

  37. 	<!-- END NAVIGATION BAR -->
    38. 

  38. 

  39. 	<div class="container body-container">
    40. 

  40. 		<div class="main-content">
    41. 

  41. 			<div class="row">
    42. 

  42.        	
    43. 

  43.        		<!-- BEGIN SIDEBAR -->
    44. 

  44.        		<div class="col-sm-3 border-right section-left">
    45. 

  45. 				<div saveheight="1" class="sidebar-nav">
    46. 

  46. 				<h4>1. OVERVIEW</h4>
    47. 

  47. 				<ul>
    48. 

  48. 					<li><a href="index.html"><span>Introduction</span></a></li>
    49. 

  49. 					<li><a href="1_changelog.html"><span>Changelog</span></a></li>
    50. 

  50. 					<li><a href="1_files.html" class="active"><span>Gravity files</span></a></li>
    51. 

  51. 				</ul>
    52. 

  52. 				
    53. 

  53. 				<h4>2. PREREQUISITES</h4>
    54. 

  54. 				<ul>
    55. 

  55. 					<li><a href="2_overview.html"><span>Overview</span></a></li>
    56. 

  56. 					<li><a href="2_array.html"><span>Array</span></a></li>
    57. 

  57. 					<li><a href="2_hash.html"><span>Hash</span></a></li>
    58. 

  58. 					<li><a href="2_memory.html"><span>Memory</span></a></li>
    59. 

  59. 					<li><a href="2_utils.html"><span>Utils</span></a></li>
    60. 

  60. 					<li><a href="2_json.html"><span>JSON</span></a></li>
    61. 

  61. 					<li><a href="2_visitor.html"><span>Visitor Pattern</span></a></li>
    62. 

  62. 					<li><a href="2_vm.html"><span>Stack vs Register VM</span></a></li>
    63. 

  63. 					<li><a href="2_class.html"><span>Class and metaclass</span></a></li>
    64. 

  64. 				</ul>
    65. 

  65. 				
    66. 

  66. 				<h4>3. COMPILER</h4>
    67. 

  67. 				<ul>
    68. 

  68. 					<li><a href="3_overview.html"><span>Overview</span></a></li>
    69. 

  69. 					<li><a href="3_grammar.html"><span>Grammar</span></a></li>
    70. 

  70. 					<li><a href="3_lexer.html"><span>Lexer</span></a></li>
    71. 

  71. 					<li><a href="3_parser.html"><span>Parser</span></a></li>
    72. 

  72. 					<li><a href="3_prattparser.html"><span>Pratt Parser</span></a></li>
    73. 

  73. 					<li><a href="3_ast.html"><span>AST</span></a></li>
    74. 

  74. 					<li><a href="3_symboltable.html"><span>Symbol Table</span></a></li>
    75. 

  75. 					<li><a href="3_semantic.html"><span>Semantic Analyses</span></a></li>
    76. 

  76. 					<li><a href="3_opcodes.html"><span>Opcodes</span></a></li>
    77. 

  77. 					<li><a href="3_ircode.html"><span>IRCode</span></a></li>
    78. 

  78. 					<li><a href="3_codegen.html"><span>Code Generation</span></a></li>
    79. 

  79. 					<li><a href="3_optimizer.html"><span>Optimizer</span></a></li>
    80. 

  80. 					<li><a href="3_bytecode.html"><span>Bytecode</span></a></li>
    81. 

  81. 				</ul>
    82. 

  82. 				
    83. 

  83. 				<h4>4. RUNTIME</h4>
    84. 

  84. 				<ul>
    85. 

  85. 					<li><a href="4_overview.html"><span>Overview</span></a></li>
    86. 

  86. 					<li><a href="4_objmodel.html"><span>Object Model</span></a></li>
    87. 

  87. 					<li><a href="4_memory.html"><span>Memory Ownership</span></a></li>
    88. 

  88. 					<li><a href="4_vm.html"><span>Virtual Machine</span></a></li>
    89. 

  89. 					<li><a href="4_performance.html"><span>Efficient Interpreter</span></a></li>
    90. 

  90. 					<li><a href="4_base.html"><span>Base Classes</span></a></li>
    91. 

  91. 					<li><a href="4_gc.html"><span>Garbage Collector</span></a></li>
    92. 

  92. 				</ul>
    93. 

  93. 				
    94. 

  94. 				<h4>5. LLVM</h4>
    95. 

  95. 				<ul>
    96. 

  96. 					<li><a href="5_overview.html"><span>Overview</span></a></li>
    97. 

  97. 					<li><a href="5_jit.html"><span>LLVM JIT</span></a></li>
    98. 

  98. 				</ul>
    99. 

  99. 				
    100. 

  100. 				</div>
    101. 

  101. 			</div>
    102. 

  102. 			<!-- END SIDEBAR -->
    103. 

  103. 			
    104. 

  104. 			<!-- BEGIN CONTENT -->
    105. 

  105.        		<div class="col-sm-9 border-left section-right">
    106. 

  106.          	<h1 class="section-header">Gravity files</h1><hr>
    107. 

  107.          				
    108. 

  108. 			<p class="section-content">
    109. 

  109. 				In order to increase modularity, Gravity is divided into 4 main components and each one (except shared) is completely independent from the others. In this way there is a clear separation between the compiler itself that end up producing the bytecode and the virtual machine that is responsible to execute that bytecode.
    110. 

  110. 			</p>
    111. 

  111. 			<p style="color: #7E267E;"><i class="fa fa-folder-o" aria-hidden="true"></i> Utils</p>
    112. 

  112. 			<ul style="list-style: none;">
    113. 

  113. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_utils: <span style="color: #797979;">Collects useful functions extensively used by other files. Time, IO, strings, UTF-8 and many other functions can be found in this file.</span></li>
    114. 

  114. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_json: <span style="color: #797979;">Very efficient JSON parser from <a href="https://github.com/udp/json-parser">https://github.com/udp/json-parser</a>.</span></li>
    115. 

  115. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_debug: <span style="color: #797979;">Contains the gravity_disassemble function used for debugging purpose.</span></li>
    116. 

  116. 				<!--<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_objc: <span style="color: #797979;">Official objc bridge used in the <a href="http://creolabs.com">Creo</a> project (not yet committed).</span></li>-->
    117. 

  117. 			</ul>
    118. 

  118. 			<p style="color: #7E267E;"><i class="fa fa-folder-o" aria-hidden="true"></i> Compiler</p>
    119. 

  119. 			<ul style="list-style: none;">
    120. 

  120. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> debug_macros: <span style="color: #797979;">Debug macros used internally during development.</span></li>
    121. 

  121. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_ast: <span style="color: #797979;">Abstract syntax tree implementation.</span></li>
    122. 

  122. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_codegen: <span style="color: #797979;">Code generation module.</span></li>
    123. 

  123. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_compiler: <span style="color: #797979;">Main compiler module that can hides other internal modules.</span></li>
    124. 

  124. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_ircode: <span style="color: #797979;">Intermediate code and register allocation management.</span></li>
    125. 

  125. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_lexer: <span style="color: #797979;">Lexer implementation.</span></li>
    126. 

  126. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_optimizer: <span style="color: #797979;">Optimizer and bytecode finalyzer.</span></li>
    127. 

  127. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_parser: <span style="color: #797979;">Parser implementation and syntax checker.</span></li>
    128. 

  128. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_semacheck1: <span style="color: #797979;">Semantic checker step 1 (used for non-local identifiers).</span></li>
    129. 

  129. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_semacheck2: <span style="color: #797979;">Semantic checker step 2 (used for local identifiers).</span></li>
    130. 

  130. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_symboltable: <span style="color: #797979;">Symbol table management and creation.</span></li>
    131. 

  131. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_token: <span style="color: #797979;">Tokenizer implementation.</span></li>
    132. 

  132. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_visitor: <span style="color: #797979;">Visitor patter for C.</span></li>
    133. 

  133. 			</ul>
    134. 

  134. 			<p style="color: #7E267E;"><i class="fa fa-folder-o" aria-hidden="true"></i> Shared</p>
    135. 

  135. 			<ul style="list-style: none;">
    136. 

  136. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_array: <span style="color: #797979;">Dynamic array macros implementation from <a href="https://github.com/attractivechaos/klib/blob/master/kvec.h">https://github.com/attractivechaos/klib/blob/master/kvec.h</a>.</span></li>
    137. 

  137. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_delegate: <span style="color: #797979;">This is where utilities are collected in a single file.</span></li>
    138. 

  138. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_hash: <span style="color: #797979;">Hash table implementation.</span></li>
    139. 

  139. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_macros: <span style="color: #797979;">Useful macros mainly used at runtime.</span></li>
    140. 

  140. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_memory: <span style="color: #797979;">Memory management module with built-in leaks checker for MacOS.</span></li>
    141. 

  141. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_opcodes: <span style="color: #797979;">Enum opcodes officially supported by Gravity.</span></li>
    142. 

  142. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_value: <span style="color: #797979;">One of the most important module that declare the struct of each object and value used inside Gravity.</span></li>
    143. 

  143. 			</ul>
    144. 

  144. 			<p style="color: #7E267E;"><i class="fa fa-folder-o" aria-hidden="true"></i> Runtime</p>
    145. 

  145. 			<ul style="list-style: none;">
    146. 

  146. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_core: <span style="color: #797979;">Core classes implementation and definition.</span></li>
    147. 

  147. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_vm: <span style="color: #797979;">Interpreter and garbage collector implementation.</span></li>
    148. 

  148. 				<li style="color: #7E267E; margin: 8px 0;"><i class="fa fa-file-text-o" aria-hidden="true"></i> gravity_vmmacros: <span style="color: #797979;">Collects various macros used by the Virtual Machine.</span></li>
    149. 

  149. 			</ul>
    150. 

  150. 			</div>
    151. 

  151.          	<!-- END CONTENT -->
    152. 

  152.          	
    153. 

  153.        	</div> <!-- /row -->
    154. 

  154.        </div> <!-- /main-content -->
    155. 

  155.      </div> <!-- /container -->
    156. 

  156. 

  157. 	<!-- BEGIN FOOTER -->
    158. 

  158. 	<footer class="navbar-fixed-bottom">
    159. 

  159. 		<div class="container footer">
    160. 

  160. 			<p>
    161. 

  161. 			</p>
    162. 

  162. 		</div>
    163. 

  163. 	</footer>
    164. 

  164.     <!-- END FOOTER -->
    165. 

  165. 	
    166. 

  166. 	<!-- Bootstrap JS -->
    167. 

  167. 	<script src="https://code.jquery.com/jquery-1.12.4.min.js"></script>
    168. 

  168. 	<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
    169. 

  169. 	
    170. 

  170. 	<!-- Highlights JS -->
    171. 

  171.     <script src="../scripts/highlight/highlight.min.js"></script>
    172. 

  172.     <script>hljs.initHighlightingOnLoad();</script>
    173. 

  173.     
    174. 

  174. 	</body>
    175. 

  175. </html>
    176.