Merge pull request #5 from microsoft/sync/ado-main

Initial sync from ADO to GitHub

Author: saurabh500

.cargo/README.md

@@ -0,0 +1,79 @@
+# Cargo Configuration Strategy
+
+This repository uses a dual-configuration approach to support both CI builds and OSS developers.
+
+## For Developers (Default)
+
+The default `.cargo/config.toml` uses **crates.io** directly:
+- No authentication required
+- Works seamlessly for OSS developers
+- No ADO access needed
+
+```bash
+# Just clone and build - works out of the box
+git clone <repo>
+cd mssql-tds
+cargo build
+```
+
+## For CI/Pipeline
+
+CI builds use `.cargo/config.ci.toml` which configures:
+- **Authenticated Azure Artifacts feeds** (`mssql-rs_Public` and `mssql-rs`)
+- Source replacement: `crates.io` → `mssql-rs_Public` (ADO feed with crates.io as upstream)
+- Authentication via `CargoAuthenticate@0` task (sets `CARGO_REGISTRIES_*_TOKEN` env vars)
+
+### How It Works
+
+1. **Apply CI config**: `.pipeline/scripts/apply-ci-cargo-config.{sh,ps1}` copies `config.ci.toml` → `config.toml`
+2. **Authenticate**: `CargoAuthenticate@0` task sets token environment variables
+3. **Build**: Cargo uses authenticated ADO feeds
+
+### Pipeline Flow
+
+```yaml
+# All build templates include these steps:
+- script: bash .pipeline/scripts/apply-ci-cargo-config.sh
+  displayName: Apply CI cargo configuration
+
+- task: CargoAuthenticate@0
+  inputs:
+    configFile: '.cargo/config.toml'
+  displayName: Authenticate cargo registries
+
+# Now cargo commands use authenticated feeds
+- script: cargo build
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `.cargo/config.toml` | **Default** - Uses crates.io (for developers) |
+| `.cargo/config.ci.toml` | **CI override** - Uses authenticated ADO feeds |
+| `.pipeline/scripts/apply-ci-cargo-config.sh` | Applies CI config (Linux/Mac) |
+| `.pipeline/scripts/apply-ci-cargo-config.ps1` | Applies CI config (Windows) |
+
+## Benefits
+
+✅ **Zero friction for OSS developers** - Just clone and build  
+✅ **Fast CI builds** - Uses ADO artifact cache  
+✅ **Secure** - Tokens only exist in CI, not committed to repo  
+✅ **Flexible** - Easy to switch between modes
+
+## Troubleshooting
+
+### For Developers
+If you see authentication errors, ensure you're using the default config:
+```bash
+git checkout .cargo/config.toml
+```
+
+### For CI
+Ensure the apply-ci-cargo-config step runs **before** `CargoAuthenticate@0`:
+```yaml
+- script: bash .pipeline/scripts/apply-ci-cargo-config.sh
+- task: CargoAuthenticate@0
+  inputs:
+    configFile: '.cargo/config.toml'
+```

.cargo/config.ci.toml

@@ -0,0 +1,22 @@
+[alias]
+bfmt = "fmt -- --check"
+bclippy = "clippy --workspace --frozen --all-features --all-targets -- -D warnings"
+btest = "llvm-cov nextest --workspace --frozen --no-report --all-targets --no-fail-fast --profile ci --success-output immediate"
+
+# CI Configuration: Uses authenticated Azure Artifacts feeds
+# This file is applied in CI pipelines before running cargo commands
+# Authentication tokens are provided by CargoAuthenticate@0 task via environment variables:
+#   - CARGO_REGISTRIES_MSSQL_RS_PUBLIC_TOKEN
+#   - CARGO_REGISTRIES_MSSQL_RS_TOKEN
+
+[registries]
+# Authenticated URLs with ~force-auth to ensure token usage
+"mssql-rs_Public" = { index = "sparse+https://pkgs.dev.azure.com/sqlclientdrivers/public/_packaging/mssql-rs_Public~force-auth/Cargo/index/" }
+"mssql-rs" = { index = "sparse+https://pkgs.dev.azure.com/sqlclientdrivers/mssql-rs/_packaging/mssql-rs~force-auth/Cargo/index/" }
+
+# Replace crates.io with our Azure Artifacts feed (with crates.io as upstream)
+[source.crates-io]
+replace-with = "mssql-rs_Public"
+
+[registry]
+global-credential-providers = ["cargo:token", "cargo:macos-keychain", "cargo:wincred"]

.cargo/config.toml

@@ -0,0 +1,10 @@
+[alias]
+bfmt = "fmt -- --check"
+bclippy = "clippy --workspace --frozen --all-features --all-targets -- -D warnings"
+btest = "llvm-cov nextest --workspace --frozen --no-report --all-targets --no-fail-fast --profile ci --success-output immediate"
+
+[registries]
+"mssql-rs_Public" = { index = "sparse+https://pkgs.dev.azure.com/sqlclientdrivers/public/_packaging/mssql-rs_Public/Cargo/index/" }
+
+[source.crates-io]
+replace-with = "mssql-rs_Public"

.config/nextest.toml

@@ -0,0 +1,19 @@
+[profile.ci.junit]  # this can be some other profile, too
+path = "junit.xml"
+
+[profile.ci]
+retries = 5
+
+# Test groups for tests that need to run sequentially
+# TLS tests have race conditions with macOS Security.framework when creating
+# PKCS12 identities in parallel, so they must run one at a time.
+[test-groups]
+tls-tests = { max-threads = 1 }
+
+[[profile.default.overrides]]
+filter = "test(mock_server_tls_tests::)"
+test-group = "tls-tests"
+
+[[profile.ci.overrides]]
+filter = "test(mock_server_tls_tests::)"
+test-group = "tls-tests"

.devcontainer/Dockerfile

@@ -0,0 +1,12 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+FROM mcr.microsoft.com/devcontainers/rust:1-1-bullseye
+
+USER vscode
+
+# Install nightly toolchain to give access to nightly features for docs-site build.
+RUN rustup toolchain install nightly
+
+# Install cargo dependencies
+RUN cargo install cargo-llvm-cov --version 0.6.16 --locked && cargo install cargo-nextest --version 0.9.99 --locked

.devcontainer/devcontainer.json

@@ -0,0 +1,35 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+{
+	"name": "Rust Ubuntu 2404",
+	"build": {
+		"dockerfile": "Dockerfile"
+	},
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	"features": {
+		"ghcr.io/devcontainers/features/azure-cli:1": {},
+		"ghcr.io/devcontainers/features/git:1": {},
+		"ghcr.io/devcontainers/features/github-cli:1": {},
+		"ghcr.io/devcontainers/features/sshd:1": {},
+		"ghcr.io/devcontainers/features/node:1": {},
+		"ghcr.io/devcontainers/features/docker-in-docker:2": {},
+		"ghcr.io/devcontainers/features/python:1": {
+			"version": "3.12"
+		}
+	},
+
+	"customizations": {
+		"vscode": {
+			"settings": {},
+			"extensions": [
+				"rust-lang.rust-analyzer",
+				"vadimcn.vscode-lldb",
+				"ms-vscode.cpptools",
+				"ms-mssql.mssql",
+				"ms-python.python"
+			]
+		}
+	},
+
+	"postCreateCommand": "/bin/bash .devcontainer/post-create.sh"
+}

.devcontainer/post-create.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+# This script is executed after the devcontainer is created
+cargo fetch
+
+curl -o- https://fnm.vercel.app/install | bash
+
+FNM_PATH="/home/vscode/.local/share/fnm"
+if [ -d "$FNM_PATH" ]; then
+  export PATH="$FNM_PATH:$PATH"
+  eval "`fnm env`"
+fi
+fnm install 20
+fnm use 20
+
+corepack enable
+
+# Setup Python virtual environment for mssql-py-core development
+echo "Setting up Python virtual environment..."
+python3 -m venv /workspaces/mssql-tds/myvenv
+source /workspaces/mssql-tds/myvenv/bin/activate
+
+# Install maturin (build tool) and dev dependencies from pyproject.toml
+pip install --upgrade pip
+pip install maturin
+pip install -e "/workspaces/mssql-tds/mssql-py-core[dev]"
+
+echo "Python venv ready at /workspaces/mssql-tds/myvenv"
+echo "Run 'source /workspaces/mssql-tds/myvenv/bin/activate' to activate"

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.githooks/pre-commit-checks.ps1

@@ -0,0 +1,4 @@
+
+cargo clippy -- -D warnings
+
+cargo fmt --check

.githooks/pre-commit-checks.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+echo " Running Clippy " 
+cargo clippy -- -D warnings
+
+echo "Running format checker" 
+
+cargo fmt --check