rsshub 1.0.0-master.f9ec483 → 1.0.0-master.fa04a11

package/lib/routes/21caijing/namespace.ts

@@ -0,0 +1,8 @@
+import type { Namespace } from '@/types';
+
+export const namespace: Namespace = {
+    name: '21财经',
+    url: '21caijing.com',
+    categories: ['finance'],
+    description: '',
+};

package/lib/routes/30secondsofcode/category.ts

@@ -0,0 +1,65 @@
+import { Data, Route } from '@/types';
+import { load } from 'cheerio';
+import ofetch from '@/utils/ofetch';
+import { processList } from './utils';
+export const route: Route = {
+    path: '/category/:category?/:subCategory?',
+    categories: ['programming'],
+    example: '/category/css/interactivity',
+    parameters: {
+        category: {
+            description: 'Main Category. For Complete list visit site "https://www.30secondsofcode.org/collections/p/1/"',
+            options: [
+                { value: 'js', label: 'Javascript' },
+                { value: 'css', label: 'CSS' },
+                { value: 'algorithm', label: 'JavaScript Algorithms' },
+                { value: 'react', label: 'React' },
+            ],
+        },
+        subCategory: {
+            description: 'Filter within Category. Visit Individual Category site for subCategories',
+        },
+    },
+    features: {
+        requireConfig: false,
+        requirePuppeteer: false,
+        antiCrawler: false,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [
+        {
+            source: ['30secondsofcode.org/:category/:subCategory/', '30secondsofcode.org/:category/'],
+            target: '/category/:category/:subCategory',
+        },
+    ],
+    name: 'Category and Subcategory',
+    maintainers: ['Rjnishant530'],
+    handler,
+};
+
+async function handler(ctx) {
+    const category = ctx.req.param('category') ?? '';
+    const subCategory = ctx.req.param('subCategory') ?? '';
+
+    const rootUrl = 'https://www.30secondsofcode.org';
+    const currentUrl = `${rootUrl}${category ? `/${category}` : ''}${subCategory ? `/${subCategory}` : ''}${category || subCategory ? '/p/1/' : ''}`;
+
+    const response = await ofetch(currentUrl);
+    const $ = load(response);
+    const heroElement = $('section.hero');
+    const heading = heroElement.find('div > h1').text();
+    const description = heroElement.find('div > p').text();
+    const image = heroElement.find('img').attr('src');
+
+    const fullList = $('section.preview-list > ul > li').toArray();
+    const items = await processList(fullList);
+    return {
+        title: heading,
+        description,
+        image: `${rootUrl}${image}`,
+        link: rootUrl,
+        item: items,
+    } as Data;
+}

package/lib/routes/30secondsofcode/namespace.ts

@@ -0,0 +1,7 @@
+import type { Namespace } from '@/types';
+
+export const namespace: Namespace = {
+    name: '30 Seconds of code',
+    url: 'www.30secondsofcode.org',
+    lang: 'en',
+};

package/lib/routes/30secondsofcode/new-and-popular.ts

@@ -0,0 +1,41 @@
+import { Data, Route } from '@/types';
+import { load } from 'cheerio';
+import { processList, rootUrl } from './utils';
+import ofetch from '@/utils/ofetch';
+
+export const route: Route = {
+    path: '/latest',
+    categories: ['programming'],
+    example: '/latest',
+    features: {
+        requireConfig: false,
+        requirePuppeteer: false,
+        antiCrawler: false,
+        supportBT: false,
+        supportPodcast: false,
+        supportScihub: false,
+    },
+    radar: [
+        {
+            source: ['30secondsofcode.org'],
+            target: '/latest',
+        },
+    ],
+    name: 'New & Popular Snippets',
+    maintainers: ['Rjnishant530'],
+    handler,
+};
+
+async function handler() {
+    const response = await ofetch(rootUrl);
+
+    const $ = load(response);
+    const fullList = $('section.preview-list > ul > li').toArray();
+    const items = await processList(fullList);
+    return {
+        title: 'New & Popular Snippets',
+        description: 'Discover short code snippets for all your development needs.',
+        link: rootUrl,
+        item: items,
+    } as Data;
+}

package/lib/routes/30secondsofcode/utils.ts

@@ -0,0 +1,54 @@
+import { DataItem } from '@/types';
+import { load } from 'cheerio';
+import ofetch from '@/utils/ofetch';
+import { parseDate } from '@/utils/parse-date';
+import cache from '@/utils/cache';
+
+export const rootUrl = 'https://www.30secondsofcode.org';
+
+export async function processList(listElements) {
+    const items = await Promise.allSettled(
+        listElements.map((item) => {
+            const $ = load(item);
+            const link = $(' article > h3 > a').attr('href');
+            const date = $(' article > small > time').attr('datetime');
+            return processItem({ link, date });
+        })
+    );
+    return items.map((item) => (item.status === 'fulfilled' ? item.value : ({ title: 'Error Reading Item' } as DataItem)));
+}
+
+async function processItem({ link: articleLink, date }) {
+    return await cache.tryGet(`30secondsofcode:${articleLink}`, async () => {
+        const finalLink = `${rootUrl}${articleLink}`;
+        const response = await ofetch(finalLink);
+        const $ = load(response);
+        const tags = $.root()
+            .find('body > main > nav > ol > li:not(:first-child):not(:last-child)')
+            .toArray()
+            .map((tag) => $(tag).find('a').text());
+        const article = $('main > article');
+        const title = article.find('h1').text();
+        article.find('img').each((_, element) => {
+            const img = $(element);
+            const src = img.attr('src');
+            if (src?.startsWith('/')) {
+                img.attr('src', `${rootUrl}${src}`);
+            }
+        });
+        const image = article.find('img').attr('src');
+        const description = article.clone().find('h1, script').remove().end().html();
+
+        return {
+            title,
+            link: finalLink,
+            pubDate: parseDate(date),
+            description,
+            author: '30 Seconds of Code',
+            category: tags,
+            image: `${rootUrl}${image}`,
+            banner: `${rootUrl}${image}`,
+            language: 'en-us',
+        } as DataItem;
+    });
+}

package/lib/routes/36kr/hot-list.ts

@@ -4,6 +4,7 @@ import got from '@/utils/got';
 import { parseDate } from '@/utils/parse-date';
 
 import { rootUrl, ProcessItem } from './utils';
+import InvalidParameterError from '@/errors/types/invalid-parameter';
 
 const categories = {
     24: {
@@ -26,7 +27,7 @@ const categories = {
 
 export const route: Route = {
     path: '/hot-list/:category?',
-    categories: ['new-media'],
+    categories: ['new-media', 'popular'],
     example: '/36kr/hot-list',
     parameters: { category: '分类，默认为24小时热榜' },
     features: {
@@ -54,6 +55,10 @@ export const route: Route = {
 async function handler(ctx) {
     const category = ctx.req.param('category') ?? '24';
 
+    if (!categories[category]) {
+        throw new InvalidParameterError('This category does not exist. Please refer to the documentation for the correct usage.');
+    }
+
     const currentUrl = category === '24' ? rootUrl : `${rootUrl}/hot-list/catalog`;
 
     const response = await got({

package/lib/routes/36kr/index.ts

@@ -18,7 +18,7 @@ const shortcuts = {
 
 export const route: Route = {
     path: '/:category/:subCategory?/:keyword?',
-    categories: ['new-media'],
+    categories: ['new-media', 'popular'],
     example: '/36kr/newsflashes',
     parameters: {
         category: '分类，必填项',

package/lib/routes/423down/index.ts

@@ -126,9 +126,9 @@ export const route: Route = {
     handler,
     example: '/423down',
     parameters: { category: '分类，默认为首页，可在对应分类页 URL 中找到' },
-    description: `:::tip
+    description: `::: tip
   若订阅 [Android - 423Down](https://www.423down.com/apk)，网址为 \`https://www.423down.com/apk\`。截取 \`https://www.423down.com/\` 到末尾的部分 \`apk\` 作为参数填入，此时路由为 [\`/423down/apk\`](https://rsshub.app/423down/apk)。
-  :::
+:::
 
   #### [安卓软件](https://www.423down.com/apk)
 

package/lib/routes/4ksj/forum.ts

@@ -19,11 +19,11 @@ export const route: Route = {
     handler,
     example: '/4ksj/4k-uhd-1',
     parameters: { id: '分类 id，默认为最新4K电影' },
-    description: `:::tip
+    description: `::: tip
   若订阅 [最新 4K 电影](https://www.4ksj.com/4k-uhd-1.html)，网址为 \`https://www.4ksj.com/4k-uhd-1.html\`。截取 \`https://www.4ksj.com/\` 到末尾 \`.html\` 的部分 \`4k-uhd-1\` 作为参数，此时路由为 [\`/4ksj/4k-uhd-1\`](https://rsshub.app/4ksj/4k-uhd-1)。
 
   若订阅子分类 [Dolby Vision 动作 4K 电影](https://www.4ksj.com/4k-uhd-s7-display-3-dytypes-1-1.html)，网址为 \`https://www.4ksj.com/4k-uhd-s7-display-3-dytypes-1-1.html\`。截取 \`https://www.4ksj.com/forum-\` 到末尾 \`.html\` 的部分 \`4kdianying-s7-dianyingbiaozhun-3-dytypes-9-1\` 作为参数，此时路由为 [\`/4ksj/4k-uhd-s7-display-3-dytypes-1-1\`](https://rsshub.app/4ksj/4k-uhd-s7-display-3-dytypes-1-1)。
-  :::`,
+:::`,
     categories: ['multimedia'],
 };
 

package/lib/routes/52hrtt/symposium.ts

@@ -31,9 +31,9 @@ export const route: Route = {
 
   访问 “邱毅看平潭” 专题，会跳转到 \`https://www.52hrtt.com/global/n/w/symposium/F1626082387819\`。其中 \`F1626082387819\` 即为 **专题 id** 对应的地区代码。
 
-  :::tip
+::: tip
   更多的专题可以点击 [这里](https://www.52hrtt.com/global/n/w/symposium)
-  :::`,
+:::`,
 };
 
 async function handler(ctx) {

package/lib/routes/591/list.ts

@@ -124,9 +124,9 @@ export const route: Route = {
     name: 'Rental house',
     maintainers: ['Yukaii'],
     handler,
-    description: `:::tip
+    description: `::: tip
   Copy the URL of the 591 filter housing page and remove the front part \`https://rent.591.com.tw/?\`, you will get the query parameters.
-  :::`,
+:::`,
 };
 
 async function handler(ctx) {