Manejo de archivos simplificado en grammY (files
)
Este plugin te permite descargar fácilmente archivos de los servidores de Telegram, y obtener una URL para que puedas descargar el archivo tú mismo.
Recuerda cómo funcionan los archivos y cómo subirlos.
Descargando Archivos
Necesitas pasar el token de tu bot a este plugin porque debe autenticarse como tu bot cuando descarga archivos. Este plugin entonces instala el método download
en los resultados de la llamada get
. Ejemplo:
import { Bot, Context } from "grammy";
import { FileFlavor, hydrateFiles } from "@grammyjs/files";
// Transformative Context flavor
type MyContext = FileFlavor<Context>;
// Crea un bot.
const bot = new Bot<MyContext>("BOT_TOKEN");
// Usa el plugin.
bot.api.config.use(hydrateFiles(bot.token));
// Descarga vídeos y GIFs en ubicaciones temporales.
bot.on([":video", ":animation"], async (ctx) => {
// Prepare el archivo para su descarga.
const file = await ctx.getFile();
// Descargue el archivo en una ubicación temporal.
const path = await file.download();
// Imprime la ruta del archivo.
console.log("Archivo guardado en ", path);
});
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
import { Bot } from "grammy";
import { hydrateFiles } from "@grammyjs/files";
// Crea un bot.
const bot = new Bot("");
// Usa el plugin.
bot.api.config.use(hydrateFiles(bot.token));
// Descarga vídeos y GIFs en ubicaciones temporales.
bot.on([":video", ":animation"], async (ctx) => {
// Prepare el archivo para su descarga.
const file = await ctx.getFile();
// Descargue el archivo en una ubicación temporal.
const path = await file.download();
// Imprime la ruta del archivo.
console.log("Archivo guardado en ", path);
});
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
import { Bot, Context } from "https://deno.land/x/grammy@v1.33.0/mod.ts";
import {
FileFlavor,
hydrateFiles,
} from "https://deno.land/x/grammy_files@v1.1.1/mod.ts";
// Transformative Context flavor
type MyContext = FileFlavor<Context>;
// Crea un bot.
const bot = new Bot<MyContext>("BOT_TOKEN");
// Usa el plugin.
bot.api.config.use(hydrateFiles(bot.token));
// Descarga vídeos y GIFs en ubicaciones temporales.
bot.on([":video", ":animation"], async (ctx) => {
// Prepare el archivo para su descarga.
const file = await ctx.getFile();
// Descargue el archivo en una ubicación temporal.
const path = await file.download();
// Imprime la ruta del archivo.
console.log("Archivo guardado en ", path);
});
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Puedes pasar una cadena con una ruta de archivo a download
si no quieres crear un archivo temporal. Simplemente haga await file
.
Si sólo quieres obtener la URL del archivo para poder descargarlo tú mismo, utiliza file
. Esto devolverá un enlace HTTPS a su archivo que es válido durante al menos una hora.
Servidor local del Bot API
Si estás usando un servidor local de Bot API, entonces la llamada get
efectivamente descarga el archivo en tu disco ya.
A su vez, puedes llamar a file
para acceder a esa ruta de archivo. Tenga en cuenta que await file
simplemente copiará ese archivo localmente presente en una ubicación temporal (o en la ruta dada si se especifica).
Apoyo a las llamadas de bot.api
Por defecto, los resultados de await bot
también contarán con los métodos download
y get
. Sin embargo, esto no se refleja en los tipos. Si necesitas estas llamadas, también debes instalar un API flavor en el objeto bot llamado File
:
import { Api, Bot, Context } from "grammy";
import { FileApiFlavor, FileFlavor, hydrateFiles } from "@grammyjs/files";
type MyContext = FileFlavor<Context>;
type MyApi = FileApiFlavor<Api>;
const bot = new Bot<MyContext, MyApi>("");
// ...
2
3
4
5
6
7
8
import { Api, Bot, Context } from "https://deno.land/x/grammy@v1.33.0/mod.ts";
import {
FileApiFlavor,
FileFlavor,
hydrateFiles,
} from "https://deno.land/x/grammy_files@v1.1.1/mod.ts";
type MyContext = FileFlavor<Context>;
type MyApi = FileApiFlavor<Api>;
const bot = new Bot<MyContext, MyApi>("");
// ...
2
3
4
5
6
7
8
9
10
11
12
Resumen del plugin
- Nombre:
files
- Fuente
- Referencia