阅读 2835

使用Deno构建一个命令行天气预报程序

在本文中,我将通过安装Deno运行时,并创建一个命令行天气程序,该程序将把一个城市名称作为参数,并返回未来24小时的天气预报。

要为Deno编写代码,我强烈建议将Visual Studio Code与官方的Deno插件一起使用。为了使事情更有趣,我们将使用TypeScript编写应用程序。

安装Deno

首先,让我们把Deno安装到本地,这样我们就可以开始编写脚本了。这个过程很简单,因为三大操作系统都有安装脚本。

Windows

在Windows上,你可以从PowerShell安装Deno:

iwr https://deno.land/x/install/install.ps1 -useb | iex
复制代码

Linux

在Linux终端上,可以使用以下命令:

curl -fsSL https://deno.land/x/install/install.sh |  sh
复制代码

macOS

在Mac上,可以将Brew与Deno一起安装:

brew install deno
复制代码

安装后

安装过程完成后,你可以通过运行以下命令检查Deno是否正确安装。

deno --version
复制代码

你现在应该看到类似以下内容:

deno 1.2.0
v8 8.5.216
typescript 3.9.2
复制代码

让我们为我们的新项目创建一个文件夹(在你的home文件夹内,或者任何你喜欢保存代码项目的地方)并添加一个 index.ts 文件。

mkdir weather-app
cd weather-app
code index.ts
复制代码

注意:正如我上面提到的,我在本教程中使用VS Code。如果你使用的是不同的编辑器,请替换上面最后一行。

获取用户输入

我们的程序将检索给定城市的天气预报,因此在运行该程序时,我们需要接受城市名称作为参数。提供给Deno脚本的参数以 Deno.args 的形式存在。让我们把这个变量记录到控制台,看看它是如何工作的。

console.log(Deno.args);
复制代码

现在,使用以下命令运行脚本:

deno run index.ts --city 杭州
复制代码

你应该看到以下输出:

[ "--city", "杭州" ]
复制代码

尽管我们可以自己解析此参数数组,但Deno的标准库包括一个名为flags的模块,它将为我们解决这一问题。要使用它,我们要做的就是在文件顶部添加一个 import 语句:

import { parse } from  "https://deno.land/std@0.61.0/flags/mod.ts";
复制代码

注意:标准库模块的文档中的例子会给你一个未版本化的URL(如deno.land/std/flags/m…

让我们使用导入的函数将参数数组解析为更有用的内容:

const args = parse(Deno.args);
复制代码

我们还将修改脚本来打印新的 args 变量,看看是什么样子的。所以现在你的代码应该是这样的:

import { parse } from  "https://deno.land/std@0.61.0/flags/mod.ts";

const args = parse(Deno.args);

console.log(args);
复制代码

现在,如果使用与以前相同的参数运行脚本,则应该看到以下输出:

Download https://deno.land/std@0.61.0/flags/mod.ts
Download https://deno.land/std@0.61.0/_util/assert.ts
Check file:///home/njacques/code/weather-app/index.ts
{ _: [], city: "杭州" }
复制代码

每当Deno运行脚本时,它都会检查新的import语句。任何远程托管的导入都将被下载,编译和缓存以备将来使用。parse 函数为我们提供了一个对象,该对象具有包含我们输入内容的 city 属性。

注意:如果你因为任何原因需要为一个脚本重新下载导入,你可以运行deno cache --reload index.ts。

我们还应该增加对 city 参数的检查,如果没有提供城市参数,则以错误信息退出程序。

if (args.city === undefined) {
  console.error("No city supplied");
  Deno.exit();
}
复制代码

使用天气API

我们将从 tianqiapi.com 获取预报数据。你需要注册一个免费账户,以获得一个API密钥。我们将使用他们的专业七日天气接口,传递一个城市名称作为参数。

https://www.tianqiapi.com/index/doc

让我们添加一些代码以获取天气预报并将其打印到控制台,以查看得到的结果:

import { parse } from  "https://deno.land/std@0.61.0/flags/mod.ts";

const args = parse(Deno.args);

if (args.city === undefined) {
    console.error("No city supplied");
    Deno.exit();
}

const appid = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const appsecret = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

const res = await fetch(`https://yiketianqi.com/api?version=v9&appid=${appid}&appsecret=${appsecret}`);
const data = await res.json();

console.log(data);
复制代码

Deno尝试在可能的情况下支持许多浏览器API,因此在这里我们可以使用 fetch 而不必导入任何外部依赖项。我们还利用了对await的支持:通常,我们必须将所有使用 await 的代码包装在 async 函数中,但是TypeScript并没有使我们这样做,这使得代码变得更好了。

如果你现在尝试运行此脚本,则会遇到错误消息:

Compile file:///Users/zhangbing/github/CodeTest/Deno/weather-app/index.ts
error: Uncaught PermissionDenied: network access to "https://yiketianqi.com/api?version=v9&appid=xxxxxxxx&appsecret=xxxxxxx", run again with the --allow-net flag
    at unwrapResponse ($deno$/ops/dispatch_json.ts:43:11)
    at Object.sendAsync ($deno$/ops/dispatch_json.ts:98:10)
    at async fetch ($deno$/web/fetch.ts:296:27)
    at async file:///Users/zhangbing/github/CodeTest/Deno/weather-app/index.ts:13:13
复制代码

默认情况下,所有Deno脚本都在安全的沙箱中运行:它们无权访问网络,文件系统或诸如环境变量之类的东西。需要为脚本明确授予对其需要访问的系统资源的权限。在这种情况下,错误消息将帮助我们了解所需的权限以及如何启用它。

让我们再次调用脚本,并带有正确的标志:

deno run --allow-net index.ts --city 杭州
复制代码

这次,我们应该从API取回JSON响应:

{
  cityid: "101210101",
  city: "杭州",
  cityEn: "hangzhou",
  country: "中国",
  countryEn: "China",
  update_time: "2020-08-13 16:51:27",
  data: [
    {
      day: "13日(星期四)",
      date: "2020-08-13",
      week: "星期四",
      wea: "多云",
      wea_img: "yun",
      wea_day: "多云",
      wea_day_img: "yun",
      wea_night: "多云",
      wea_night_img: "yun",
      tem: "37",
      tem1: "38",
      tem2: "28",
      humidity: "40%",
      visibility: "暂缺",
      pressure: "1002",
      win: [ "西南风", "无持续风向" ],
      win_speed: "4-5级转<3级",
      win_meter: "小于12km/h",
      sunrise: "05:24",
      sunset: "18:43",
      air: "35",
      air_level: "优",
      air_tips: "空气很好,可以外出活动,呼吸新鲜空气,拥抱大自然!",
      alarm: {
        alarm_type: "高温",
        alarm_level: "橙色",
        alarm_content: "杭州市气象台2020年8月13日9时05分发布高温橙色预警信号:受副热带高压控制,预计今天主城区和钱塘新区最高气温将达38℃左右,请注意做好防暑降温等工作。(预警信息来源:国家预警信息发布中心)"
      },
      hours: [
        [Object], [Object],
        [Object], [Object],
        [Object], [Object],
        [Object], [Object],
        [Object], [Object],
        [Object], [Object],
        [Object], [Object],
        [Object], [Object]
      ],
      index: [ [Object], [Object], [Object], [Object], [Object], [Object] ]
    },
    ... ...
  ]
}
复制代码

返回字段的含义可以查看API文档data 数组就是每日数据列表,1-7日,共7组。每个对象中包含气象预警(alarm)、小时预报(hours)、生活指数(index)、空气质量指数(aqi) 数据。

为了简单起见,我们只获取几个简单的数据:日期、天气、实时温度空和空气质量等级四个数据,为此需要遍历数组:

const forecast = data.data.map((item) => [
  item.day, // 日期
  item.wea, // 天气
  item.tem, // 实时温度
  item.air_level, // 空气质量等级
]);
复制代码

如果我们现在尝试运行脚本,我们会得到一个编译错误(如果你使用像VS代码这样的IDE,在键入代码时也会得到这个错误):参数 ' item’ 隐式地具有一个 ‘any' 类型。

TypeScript要求我们告诉它该 item 是什么类型的变量,以便知道我们是否对它做了任何可能在运行时导致错误的事情。让我们添加一个接口,以描述 item 的结构:

interface forecastItem {
  day: string;
  wea: string;
  tem: string;
  air_level: string;
}
复制代码

让我们将新类型添加到map回调中:

const forecast = data.data.map((item: forecastItem) => [
  item.day, // 日期
  item.wea, // 天气
  item.tem, // 实时温度
  item.air_level, // 空气质量等级
]);
复制代码

如果你使用的IDE支持TypeScript,它应该能够在你输入时自动完成 item 的类型,这要感谢我们提供的接口类型。

现在运行结果输入如下:

forecast [
  [ "13日(星期四)", "多云转晴", "36", "优" ],
  [ "14日(星期五)", "晴", "37", "" ],
  [ "15日(星期六)", "晴", "37", "" ],
  [ "16日(星期日)", "多云转晴", "37", "" ],
  [ "17日(星期一)", "晴", "37", "" ],
  [ "18日(星期二)", "晴", "37", "" ],
  [ "19日(星期三)", "晴", "38", "" ]
]
复制代码

格式化输出

现在我们有了所需的数据集,接下来让我们来看一下如何格式化它以便显示给用户。让我们使用 ascii_table 模块将其显示在整洁的小表中:

import AsciiTable from 'https://deno.land/x/ascii_table/mod.ts';

...

const table = AsciiTable.fromJSON({
  title: `${args.city}七日天气预报`,
  heading: [ '日期', '天气', '实时温度', '风', '空气质量', '天气预警'],
  rows: forecast
})

console.log(table.toString())
复制代码

保存并运行脚本,现在我们应该已经对接下来的7日内的所选城市进行了格式化并给出了预报:

完整代码清单

这是一个紧凑的脚本,但是下面是完整的代码清单,也可去我的 Github

import { parse } from "https://deno.land/std@0.61.0/flags/mod.ts";
import AsciiTable from "https://deno.land/x/ascii_table/mod.ts";

const args = parse(Deno.args);

if (args.city === undefined) {
  console.error("No city supplied");
  Deno.exit();
}

// 你自己的API密钥
const appid = "xxxxxxxx";
const apiKey = "xxxxxxxxx";

const res = await fetch(
  `https://yiketianqi.com/api?version=v9&appid=${appid}&appsecret=${apiKey}`,
);
const data = await res.json();

interface forecastItem {
  day: string;
  wea: string;
  tem: string;
  air_level: string;
}

const forecast = data.data.map((item: forecastItem) => [
  item.day, // 日期
  item.wea, // 天气
  item.tem, // 实时温度
  item.air_level, // 空气质量等级
]);

const table = AsciiTable.fromJSON({
  title: `${args.city}七日天气预报`,
  heading: ["日期", "天气", "温度", "空气质量"],
  rows: forecast,
});

console.log(table.toString());
复制代码

总结

现在,你有了自己的正在运行的Deno命令行程序,该程序将为你提供接下来7日天气预报。通过遵循本教程,你现在应该熟悉如何启动新程序,从标准库和第三方导入依赖项以及授予脚本权限。

那么,在尝到了为Deno编写程序的甜头之后,接下来你应该去哪里呢?你觉得Deno如何?