Whether they be in code, interesting feature suggestions, design critique or bug reports, all contributions are welcome. Please start an issue, before investing a lot of work. This helps avoid situations there I would feel the need to reject a large body of work, and a lot of your time has been wasted. odbc2parquet is a pet project and a work of love, which implies that I maintain it in my spare time. Please understand that I may not always react immediately. If you contribute code to fix a Bug, please also contribute the test to fix it. Happy contributing.
Running local tests currently requires:
- Docker and Docker compose.
Should you use Visual Studio Code with the Remote Development extension, it will pick up the .devcontainer configuration and everything should be setup for you.
With docker installed run:
docker-compose upThis starts two containers called odbc2parquet_dev and odbc2parquet_mssql. You can use the dev container to build your code and execute tests in case you do not want to install the required ODBC drivers and/or Rust tool chain on your local machine.
Otherwise you can manually install these requirements from here:
- Install Rust compiler and Cargo. Follow the instructions on this site.
- Microsoft ODBC Driver 18 for SQL Server.
- An ODBC Driver manager if you are not on windows: http://www.unixodbc.org/
- The command line tools shipping with the
parquetcrate are invoked by the tests.cargo install parquet --features cli.
We now can execute the tests in Rust typical fashion using:
cargo test
to run all tests in the workspace.