History

Sergio Benitez 65baa83fb4 Update dependencies. * 'memchr' to 2.0 * 'base64' to 0.9 * 'smallvec' to 0.6 * 'lazy_static' to 1.0 Update example dependencies. * 'rand' to 0.4 * 'parking_lot' to 0.5		2018-01-05 02:00:26 -08:00
..
db	Add tests for 'todo' example.	2017-05-26 16:52:17 -07:00
migrations	Update docs and examples for diesel 1.0.0-rc1.	2018-01-03 01:38:05 -08:00
src	Update docs and examples for diesel 1.0.0-rc1.	2018-01-03 01:38:05 -08:00
static	Rename '#[error]' to '#[catch]', 'errors!' to 'catchers!'.	2017-09-22 19:04:14 -07:00
Cargo.toml	Update dependencies.	2018-01-05 02:00:26 -08:00
README.md	Improve bootstrapping instructions in todo example.	2017-08-13 02:50:28 -07:00
Rocket.toml	Add the [global] psuedo-environment for global configuration.	2016-10-31 17:00:32 +01:00
bootstrap.sh	Properly handle paths with spaces in shell scripts.	2017-09-07 17:07:31 -07:00

README.md

Rocket Todo Example

This example makes use of a SQLite database via diesel to store todo tasks. As a result, you'll need to have sqlite3 and its headers installed:

OS X: brew install sqlite
Debian/Ubuntu: apt-get install libsqlite3-dev
Arch: pacman -S sqlite

Running

Before running, building, or testing this example, you'll need to ensure the following:

A SQLite database file with the proper schema is present.

On a Unix machine or with bash installed, you can simply run the boostrap.sh script to create the database. The script installs the diesel_cli tools if they're not already installed and runs the migrations. The script will output a DATABASE_URL variable.

You can also install the Diesel CLI and run the migrations manually with the following commands:
```
# install Diesel CLI tools
cargo install diesel_cli --no-default-features --features sqlite

# create db/db.sql
DATABASE_URL=db/db.sql diesel migration run
```
A DATABASE_URL environment variable is set that points to the SQLite database file.

Use the DATABASE_URL variable emitted from the bootstrap.sh script, or enter it manually, as follows:
- DATABASE_URL=db/db.sql cargo build
- DATABASE_URL=db/db.sql cargo test
- DATABASE_URL=db/db.sql cargo run