npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@microsoft/ads-service-downloader

v1.2.2

Published

Download a file and decompress it. Designed for use with Azure Data Studio

Downloads

283

Readme

ADS Service Downloader

Download a file and decompresses it. Designed for use with Azure Data Studio.

Usage

⚠️IMPORTANT⚠️: The runtime mapping logic has changed significantly in 1.0.0. If upgrading from an earlier version make sure to update your config appropriately.

Sample code

const serverdownloader = new ServerProvider(config);
const executablePath = await serverdownloader.getOrDownloadServer();

Sample configuration file

{
	"downloadUrl": "https://github.com/Microsoft/sqltoolsservice/releases/download/{#version#}/microsoft.sqltools.servicelayer-{#fileName#}",
	"version": "4.3.0.26",
	"downloadFileNames": {
		"Windows_86": "win-x86-net6.0.zip",
		"Windows_64": "win-x64-net6.0.zip",
		"OSX": "osx-x64-net6.0.tar.gz",
		"CentOS": "centos-x64-net6.0.tar.gz",
		"Ubuntu_16": "ubuntu16-x64-net6.0.tar.gz",
		"Ubuntu": "ubuntu-x64-net6.0.tar.gz",
		"Linux": "linux-x64-net6.0.tar.gz",
	},
	"installDirectory": "./sqltoolsservice/{#platform#}/{#version#}",
	"executableFiles": ["MicrosoftSqlToolsServiceLayer.exe", "MicrosoftSqlToolsServiceLayer"],
	"retry": {
		"retries": 15,
		"factor": 2,
		"minTimeout": 1000,
		"maxTimeout": 300000,
		"randomize": false
	}
}

Properties

downloadUrl: The template of the url to the service file. 2 placeholder variables are supported in this property.

1. `{#version#}`: The version of the service defined by the `version` property.
2. `{#fileName#}`: The matching value of the key-value pair in `downloadFileNames` property.

version: The version of the service.

downloadFileNames: The mapping between the runtimes (OS + OS Version) and their correspondent service files.

1. The supported runtimes are defined in the [Runtime enum](https://github.com/microsoft/ads-service-downloader/blob/main/src/platform.ts#L13). 
2. A fallback mechanism is available in case the current runtime is not specified in the config, e.g. the current runtime is Ubuntu 22, but it is not defined in the config, the package will also try Ubuntu and Linux until an entry is found. the fallback information is defined in the [fallback function](https://github.com/microsoft/ads-service-downloader/blob/main/src/platform.ts#L262). Follow the guidelines below to simplify the mapping information:
	a. When possible, define the platform level config, e.g. Linux and set its value to a service file that works for most of Linux distributions.
	b. Only define the specific runtime if necessary. e.g. Ubuntu 22 requires its own version of service file.

Please file an issue if a specific runtime that requires special handling is not listed in the runtime list.

Development

  • yarn install
  • yarn compile to compile sources
  • yarn test to run tests

Releasing

Release a new version of the extension by:

  1. git checkout main
  2. git pull
  3. Update version in package.json and commit/push that change
  4. git tag <version> (e.g. git tag 0.2.2)
  5. Run git push --tags
  6. The release will be created in Github automatically by the CD pipeline, go to it and download the package artifact (tgz)
  7. Run npm publish <path to tarball>

License

MIT

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.