{"id":17781710,"url":"https://github.com/dwarf1er/sqlanydb-tools","last_synced_at":"2026-04-15T22:31:43.888Z","repository":{"id":259277778,"uuid":"865052457","full_name":"Dwarf1er/sqlanydb-tools","owner":"Dwarf1er","description":"A suite of CLI tools and a VSCode extension for managing SAP SQL Anywhere 17 databases, streamlining development and database tasks.","archived":false,"fork":false,"pushed_at":"2024-11-01T02:18:22.000Z","size":511,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-14T13:16:25.996Z","etag":null,"topics":["database","migration-tool","sap","sql","sqlanywhere","sybase","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dwarf1er.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-29T21:20:28.000Z","updated_at":"2024-10-23T19:01:04.000Z","dependencies_parsed_at":"2024-10-24T03:24:28.625Z","dependency_job_id":"588881a4-fe1e-41e4-9040-02039ba5e2c5","html_url":"https://github.com/Dwarf1er/sqlanydb-tools","commit_stats":null,"previous_names":["dwarf1er/sqlanydb-tools"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fsqlanydb-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fsqlanydb-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fsqlanydb-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dwarf1er%2Fsqlanydb-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dwarf1er","download_url":"https://codeload.github.com/Dwarf1er/sqlanydb-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229705502,"owners_count":18110794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","migration-tool","sap","sql","sqlanywhere","sybase","vscode-extension"],"created_at":"2024-10-27T04:04:17.794Z","updated_at":"2026-04-15T22:31:43.856Z","avatar_url":"https://github.com/Dwarf1er.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# SQL Anywhere Tools\n\n##### Complete toolbox for SAP SQL Anwyhere 17\n\n\u003cimg alt=\"sqlanydb-tools-logo\" height=\"280\" src=\"./assets/sqlanydb-tools-logo.png\" /\u003e\n\u003c/div\u003e\n\n# Project Description\n\nThe SQL Anywhere Tools project is a comprehensive suite of tools designed to simplify and streamline the management and development of SAP SQL Anywhere 17 databases. This project consists of a set of CLI tools for common database operations and a VSCode extension that integrates all of these tools into a seamless development environment.\n\nBy bundling both command-line utilities and an integrated VSCode experience in a single monorepo, this toolbox enables developers and DBAs to perform essential tasks more efficiently, whether working directly with the command line or within their IDE.\n\n# Table Of Contents\n\n-   [SQL Anywhere Tools](#sql-anywhere-tools) - [Complete toolbox for SAP SQL Anwyhere 17](#complete-toolbox-for-sap-sql-anwyhere-17)\n-   [Project Description](#project-description)\n-   [Table Of Contents](#table-of-contents)\n-   [Feature Roadmap](#feature-roadmap)\n-   [Installation](#installation)\n    -   [VSCode extension](#vscode-extension)\n    -   [sqlanydb-manager CLI](#sqlanydb-manager-cli)\n-   [Usage](#usage)\n-   [Development](#development)\n    -   [Prerequisites](#prerequisites)\n    -   [Development Environment Setup](#development-environment-setup)\n    -   [Running the CLI tools](#running-the-cli-tools)\n        -   [sqlanydb-manager](#sqlanydb-manager)\n    -   [Running the VSCode extension](#running-the-vscode-extension)\n-   [License](#license)\n\n# Feature Roadmap\n\n-   sqlanydb-manager CLI tool: start, stop, reset and ping local databases [X]\n    -   accompanying feature support in sqlanydb-tools-vscode extension [X]\n-   database connector through sajdbc4.jar \u0026 dbjdbc17.jar included with sql anywhere [ ]\n    -   accompanying feature support to run queries in sqlanydb-tools-vscode extension [ ]\n-   sql anywhere language parser with ANTLR [ ]\n    -   accompanying syntax highlighting in sqlanydb-tools-vscode extension [ ]\n    -   prettier-plugin-sqlanydb for sql anywhere auto formatting support [ ]\n-   LSP to suggest autocompletions based on database schema [ ]\n-   sqlanydb-migrator CLI tool: migration support for database development [ ]\n    -   accompanying feature support in sqlanydb-tools-vscode extension [ ]\n-   database explorer in sqlanydb-tools-vscode-extension [ ]\n\n# Installation\n\n## VSCode extension\n\nThere are 2 ways to install the VSCode extension:\n\n1. Navigate to the `Extensions` tab in VSCode and search for `sqlanydb-tools-vscode`\n2. Download the VSIX file from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=dwarf1er.sqlanydb-tools-vscode)\n\n## sqlanydb-manager CLI\n\n[(Back to top)](#table-of-contents)\n\n# Usage\n\n[(Back to top)](#table-of-contents)\n\n# Development\n\n## Prerequisites\n\n1. SAP SQL Anywhere 17\n   You will need to have SAP SQL Anywhere 17 installed on your machine. You can obtain a developer license [here](https://www.sqlanywhere.info/EN/sql-anywhere/sql-anywhere-trial.html)\n2. Create a SAP SQL Anywhere 17 Development Databse\n   Once you have installed SAP SQL Anywhere 17, open `SQL Central` and in the top bar of the application go to `Tools \u003e SQL Anwyhere 17 \u003e Create Database...` and follow the prompts\n3. Node.JS (version 22.9.0)\n   You can check your NodeJS version with the following command:\n    ```bash\n    node -v\n    ```\n    If you don't have the required version you can install it from the official [Node.JS website](https://nodejs.org) or use a node version manager like [nvm](https://github.com/nvm-sh/nvm) or [nvm for windows](https://github.com/coreybutler/nvm-windows) to manage multiple versions.\n4. Turborepo\n   This project uses [turbo](https://turbo.build) to manage and build multiple packages in the monorepo efficiently. You will need to install turborepo globally:\n    ```bash\n    npm install -g turbo\n    ```\n5. ts-node\n   To make it easier to run and test the CLI and packages written in TypeScript, we recommend using [ts-node](https://www.npmjs.com/package/ts-node). You will need to install it globally:\n    ```bash\n    npm install -g ts-node\n    ```\n\n## Development Environment Setup\n\nOnce you have all the prerequisites installed, follow these steps to get your development environment up and running:\n\n1. Clone the repository\n    ```bash\n    git clone https://github.com/Dwarf1er/sqlanydb-tools.git\n    ```\n2. Install dependencies\n    ```bash\n    npm install\n    ```\n3. Build the project\n    ```bash\n    turbo run build\n    ```\n\n## Running the CLI tools\n\nTo run the command-line tools locally, use the following command:\n`bash\n    ts-node /path/to/clit-tools.ts\n    `\n\n### sqlanydb-manager\n\nFor sqlanydb-manager, rename `config.example.json` to `config.json` and fill it in with the appropriate information considering the database that you created in `step 2` of [Prerequisites](#prerequisites)\n\n## Running the VSCode extension\n\nWhen working on this project in VSCode you can press `F5` to launch the extension in a new `Extension Development Host` window\n\n[(Back to top)](#table-of-contents)\n\n# License\n\nThis project is licensed under the [MIT License](LICENSE)\n\n# Acknowledgements\n\n- A massive shoutout to [alexandre-lavoie](https://github.com/alexandre-lavoie/) for rescuing me from the depths of my own misguided \"brilliance\"! Your help on restructuring this project transformed the chaos into something that actually works.\n\nCheck out [alexandre-lavoie's](https://github.com/alexandre-lavoie/) awesome projects [here](https://github.com/alexandre-lavoie?tab=repositories)!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwarf1er%2Fsqlanydb-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdwarf1er%2Fsqlanydb-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwarf1er%2Fsqlanydb-tools/lists"}