Security News
Cloudflare Adds Security.txt Setup Wizard
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
dark-sky-api
Advanced tools
A simple and robust wrapper library for Dark Sky API (previously known as Forecast.io).
Features:
See Dark Sky developer docs: https://darksky.net/dev/docs.
Need something even smaller? Dark sky api uses dark-sky-skeleton.
npm install dark-sky-api
import DarkSkyApi from 'dark-sky-api';
Configuring dark-sky-api with an api key is supported but each request will expose said api key (for anyone to capture).
For this reason Dark Sky strongly suggests hiding your API key through use of a proxy [ref].
// one of the two is required
DarkSkyApi.apiKey = 'your-dark-sky-api-key';
DarkSkyApi.proxyUrl = '//base-url-to-proxy/service';
// optional configuration
DarkSkyApi.units = 'si'; // default 'us'
DarkSKyApi.language = 'de'; // default 'en'
DarkSkyApi.postProcessor = (item) => { // default null;
item.day = item.dateTime.format('ddd');
return item;
}
Today's weather:
DarkSkyApi.loadCurrent()
.then(result => console.log(result));
Forecasted week of weather:
DarkSkyApi.loadForecast()
.then(result => console.log(result));
By default dark-sky-api will use Geolocation.getCurrentPosition to grab the current browser location automatically.
To manually set geolocation position pass along a position object:
const position = {
latitude: 43.075284,
longitude: -89.384318
};
DarkSkyApi.loadCurrent(position)
.then(result => console.log(result));
To get the units used in dark sky api responses per configured unit type (default is 'us') use GetResponseUnits after configuration. Keep in mind that the units would need to be retrieved again if you changed the api units.
const responseUnits = DarkSkyApi.getResponseUnits();
DarkSkyAPi.loadCurrent()
.then((data) => {
console.log(`The temperature is ${data.temperature} degrees ${responseUnits.temperature}`);
console.log(`The wind speed is ${data.windSpeed} ${responseUnits.windSpeed}`);
});
The post processor method is mapped to all weather items. It's an easy way to add or manipulate responses for an app.
// import
import DarkSkyApi from 'dark-sky-api';
// configure
DarkSkyApi.apiKey = 'my-api-key';
DarkSkyApi.postProcessor = (item) => { // must accept weather data item param
// add a nice date representation using moment.calender
item.dayNice = item.dateTime.calendar(null, {
sameDay: '[Today]',
nextDay: 'ddd',
nextWeek: 'ddd',
lastDay: '[Yesterday]',
lastWeek: '[Last] ddd',
sameElse: 'ddd'
});
// add units object onto item
item.units = DarkSkyApi.getResponseUnits(); // this would be outdated if you changed api units later
return item; // must return weather dat item
};
// use
DarkSkyApi.loadCurrent()
.then(data => console.log(data.dayNice)); // Today
To retrieve any of these results use loadItAll with optional excludesBlock
DarkSkyApi.loadItAll()
.then(console.log);
DarkSkyApi.loadItAll('daily,hourly,minutely,flags') // just return alerts
DarkSkyApi.loadItAll(excludes, position); // explicit position is second argument
tldr: it's automatic, but configure first or do it manually.
Implicit (suggested)
This happens automatically when making a method call such as loadCurrent or LoadForecast. Remember to configure before hand.
explicite
DarkSkyApi.apiKey = 'my-api-key';
DarkSkyApi.initialize();
or
DarkSkyApi.initialize(apiKey, proxyUrl, units, language, postProcessor); // only apiKey or proxyUrl are required
DarkSkyApi.setUnits('auto');
DarkSkyApi.setLanguage('x-pig-latin');
DarkSkyApi.setPostProcessor((item) => {
return {
temperature: item.temperatureMax || item.temperature,
icon: item.icon
};
})
If you need to maintain multiple instances (configurations) of dark-sky-api create an instance.
// import
import DarkSkyApi from 'dark-sky-api';
// instantiate
const api = new DarkSkyApi(apiKey, proxyUrl, units, language, processor); // only apiKey or proxyUrl are required
// instance config methods support method chaining
api.units('us')
.language('en')
.postProcessor(item => item)
.loadCurrent()
.then(console.log);
// change position
position = {
latitude: 43.075284,
longitude: -89.384318
};
api.setPosition(position);
// change back
api.loadPositionAsync() // get current position
.then(position => {
api.setPosition(position);
});
FAQs
a simple and robust dark sky api service for client-side js
The npm package dark-sky-api receives a total of 69 weekly downloads. As such, dark-sky-api popularity was classified as not popular.
We found that dark-sky-api demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
Security News
The Socket Research team breaks down a malicious npm package targeting the legitimate DOMPurify library. It uses obfuscated code to hide that it is exfiltrating browser and crypto wallet data.
Security News
ENISA’s 2024 report highlights the EU’s top cybersecurity threats, including rising DDoS attacks, ransomware, supply chain vulnerabilities, and weaponized AI.