Read compiler configurations from toml

Cargo.toml

@@ -60,6 +60,7 @@ scale-info = "2.4"
 petgraph = "0.6.3"
 wasmparser = "0.106.0"
 wasm-encoder = "0.28"
+toml = "0.7"
 wasm-opt = { version = "0.112.0", optional = true }
 contract-build = { version = "3.0.1", optional = true }
 

docs/running.rst

@@ -131,6 +131,26 @@ Options:
 \-\-release
    Disable all debugging features for :ref:`release`
 
+\-\-config-file
+  Read compiler configurations from a ``.toml`` file. The minimal fields required in the configuration file are:
+
+  .. code-block:: toml
+
+    [package]
+    input_files = ["flipper.sol"]  # Solidity files to compile
+
+    [target]
+    name = "solana"  # Target name
+
+
+  Fields not explicitly present in the .toml acquire the compiler's default value.
+  If any other argument is provided in the command line, for example, ``solang compile --config-file --target substrate``, the argument will be overridden.
+  The priority for the args is given as follows:
+  1. Command line
+  2. Configuration file
+  3. Default values.
+  The default name for the toml file is "solang.toml". If two configuration files exist in the same directory, priority will be given to the one passed explicitly to this argument.
+
 \-\-wasm-opt
    wasm-opt passes for Wasm targets (0, 1, 2, 3, 4, s or z; see the wasm-opt help for more details).
 
@@ -142,6 +162,21 @@ Options:
     Solang will not give a warning about this problem.
 
 
+
+Starting a new project
+______________________________
+
+
+  solang new \-\-target solana my_project
+
+A solang project is a directory in which there are one or more solidity files and a ``solang.toml`` file where 
+the compilation options are defined. Given these two components, a user can run ``solang compile`` in a similar fashion as ``cargo build``.
+
+The ``solang new`` command creates a new solang project with an example `flipper <https://github.com/hyperledger/solang/blob/main/examples/solana/flipper.sol>`_ contract,
+and a default ``solang.toml`` configuration file.
+
+
+
 Generating Documentation Usage
 ______________________________
 

examples/solana/flipper.sol

@@ -4,7 +4,7 @@ contract flipper {
 
 	/// Constructor that initializes the `bool` value to the given `init_value`.
 	@payer(payer)
-	constructor(address payer, bool initvalue) {
+	constructor(bool initvalue) {
 		value = initvalue;
 	}
 

examples/solana/solana_config.toml

@@ -0,0 +1,29 @@
+[package]
+input_files = ["flipper.sol"]   # Files to be compiled. You can define multiple files as : input_files = ["file1", "file2", ..]
+contracts = ["flipper"] # Contracts to include from the compiled files
+import_path = []   
+import_map = {}   # Maps to import. Define as  import_map = {map = "path/to/map1", map2 = "path/to/map2"}
+
+
+[target]
+name = "solana" # Valid targets are "solana" and "substrate"
+
+[debug-features]
+prints = true   # Log debug prints to the environment.
+log-runtime-errors = true   # Log runtime errors to the environment.
+generate-debug-info = false  # Add debug info to the generated llvm IR.
+
+[optimizations]
+dead-storage = true
+constant-folding = true
+strength-reduce = true
+vector-to-slice = true
+common-subexpression-elimination = true
+llvm-IR-optimization-level = "default"  # Set llvm optimizer level. Valid options are "none", "less", "default", "aggressive"
+
+[compiler-output]
+verbose = false    # show debug messages
+#emit = "llvm-ir"   # Emit compiler state at early stage. Valid options are: "ast-dot", "cfg", "llvm-ir", "llvm-bc", "object", "asm".
+#output_directory = "path/to/dir"   
+#output_meta = "path/to/dir"  # output directory for metadata
+std_json_output = false        # mimic solidity json output on stdout

examples/substrate/substrate_config.toml

@@ -0,0 +1,32 @@
+[package]
+input_files = ["flipper.sol"]   # Files to be compiled. You can define multiple files as : input_files = ["file1", "file2", ..]
+contracts = ["flipper"] # Contracts to include from the compiled files
+import_path = []   
+import_map = {}   # Maps to import. Define as  import_map = {map = "path/to/map1", map2 = "path/to/map2"}
+
+
+[target]
+name = "substrate"  # Valid targets are "solana" and "substrate"
+address_length = 32
+value_length = 16
+
+
+[debug-features]
+prints = true   # Log debug prints to the environment.
+log-runtime-errors = true   # Log runtime errors to the environment.
+generate-debug-info = false  # Add debug info to the generated llvm IR.
+
+[optimizations]
+dead-storage = true
+constant-folding = true
+strength-reduce = true
+vector-to-slice = true
+common-subexpression-elimination = true
+llvm-IR-optimization-level = "default"  # Set llvm optimizer level. Valid options are "none", "less", "default", "aggressive"
+
+[compiler-output]
+verbose = false    # show debug messages
+#emit = "llvm-ir"   # Emit compiler state at early stage. Valid options are: "ast-dot", "cfg", "llvm-ir", "llvm-bc", "object", "asm".
+#output_directory = "path/to/dir"   
+#output_meta = "path/to/dir"  # output directory for metadata
+std_json_output = false        # mimic solidity json output on stdout