Skip to content

Latest commit

 

History

History
19 lines (15 loc) · 1.8 KB

README.md

File metadata and controls

19 lines (15 loc) · 1.8 KB

Example

Before starting

Please follow the the install procedure. Before running CLI commands, we encourage you to explore what it can do and what options it offers via the --help flag.

Take a look!

This crate contains a fully working example. There are a few queries and migrations defined for you in the migrations/ and queries/ folders. The Rust modules have already been generated in the src/cornucopia.rs file. Finally, in src/main.rs you can see the queries in action, as you would use them in your own project. Taking a look should give you a solid idea of what cornucopia is about, enough to get you started in your own project. Bear in mind that while it is instructive to look at this example, you will need a live database to actually execute the main file of this example since it tries to run the queries against an actual database..

(Optional) Running the example

If you want to be able to run this example, you should

  • Have a reachable postgres database up-and-running (container or otherwise).
  • Modify the connection pool config (user, password, etc.) in main.rs so that it can connect to your database.
  • Run the migrations (with cornucopia migration run or otherwise).
  • That's it! You should now be able to run the example.

Start experimenting

Feel free to modify the migrations, or add new ones with cornucopia migration new. You can also add or modify queries with your favorite SQL tool (no special command needed). When you're done modifying, rebuild the Rust modules for your SQL with cornucopia generation. This will recreate the src/cornucopia.rs file.

Going deeper

If you want to know more, the project's readme explains pretty much everything there is to know about Cornucopia. The CLI's --help flag is also handy.