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

open-categories

v1.3.0

Published

An open categorization system for platforms that handle information about food, fashion, technology and others

Downloads

2

Readme

Open Categories

An open categorization system for platforms that handle information about food, fashion, technology and others

See ALL the categories in CATEGORIES.md

Why Open Categories?

Open Categories aim to be an aid for the developers and the companies that need to categorize information.

These are some of the products that may use Open Categories. For example:

  • AI Applications
    • Image recognition
    • Chatbots
  • Online stores
  • Search engines
  • Games (For categorizing in-game items)

We want to build a categorization system that is both semantic, fast and useful for everybody to use, and not to reinvent the wheel on each new application.

At the end, having a common categorization system makes it easier to communicate between different apps and platforms.

Principles

In Open Categories, whatever can be categorized with a simple slug. A slug is a piece of texts that contains very useful information.

For example, if we had the string food_fast_pizza, we could split it in the following way:

  • food_fast_pizza: The sub sub category (Pizza)
  • food_fast: The sub category (Fast Food)
  • food: The topmost category (Food in general)

So, with one simple string we can classify whatever.

Let's take a look at other example:

  • food_drinks_liquor_tequila: The sub sub sub category (Tequila)
  • food_drinks_liquor: The sub sub category (Liquor)
  • food_drinks: The sub category (Drinks)
  • food: The topmost category (Food in general)

This categorization is available as a node module, but we provide JSON and YAML files for you to copy and use with other languages :)

This module will help you parse and understand more about the categories, and also perform fuzzy searches

We are also commited to semver, so our versions and releases will be semantic

Installation

With npm: npm install --save open-categories

With yarn: yarn add open-categories

Usage

Importing the class

import { OpenCategories } from 'open-categories';

// or, with require:
const { OpenCategories } = require('open-categories');

Getting a specific category

const category = OpenCategories.getCategory('fashion_shoes_sport');
console.log(category); 
/*
{
  "name":"sport shoes",
  "translationsArray":[
    {"lang":"es","text":"zapatos deportivos"},
    {"lang":"en","text":"sport shoes"}
  ],
  "translations": {"es":"zapatos deportivos","en":"sport shoes"},
  "path":"fashion_shoes_sport"
}
*/

Searching

This library also comes with fuzzy search, backed up by fuse.js, so you can easily run:

const results = OpenCategories.search('sport sho');
console.log(results); 
/*
[{
  "name":"sport shoes",
  "translationsArray":[
    {"lang":"es","text":"zapatos deportivos"},
    {"lang":"en","text":"sport shoes"}
  ],
  "translations": {"es":"zapatos deportivos","en":"sport shoes"},
  "path":"fashion_shoes_sport"
}, {...}, {...}]
*/

Getting the topmost category for any subcategory

At some point you would like to get information about the topmost category for any given subcategory

For example: food_mexican -> food

You could do this with getTopMostCategory

const topMost = OpenCategories.getTopMostCategory('food_mexican');
console.log(topMost);
/*
{
  "name":"food",
  "translationsArray":[{"lang":"es","text":"comida"}],
  "translations":{"es":"comida"},
  "path":"food",
  "topmost":true
}
*/

Getting the parent category

For example: food_drinks_liquor -> food_drinks

You could do this with getParentCategory

const topMost = OpenCategories.getTopMostCategory('food_drinks_liquor');
console.log(topMost);
/*
{
  "path":"food_drinks",
  ...
}
*/

Getting all the slugs for one or several given categories

This is useful for understanding all the posible categories and subcategories that are present in any given array of slugs

For example: ['food_drinks_liquor'] => ['food','food_drinks','food_drinks_liquor']

const slugs = OpenCategories.getAllSlugsForCategories(['food_drinks_liquor', 'fashion_jewelry']);
console.log(slugs);
/*
food
food_drinks
food_drinks_liquor
fashion
fashion_jewelry
*/

Files

  • categories.yaml: Main file for the categories
  • src/_postBuild.ts: Generates the categories-array and categories-tree JSON files out of categories.yaml
  • src/index.ts: Exposes the Typescript API later compiled to out/index.js (main package file)
  • src/Converter.ts: Handles the conversion from YAML to JSON

Collaboration

  • Clone this repo, and start adding your code in the index.ts file, or adding categories / translations in categories.yaml
  • When you are done, write the tests in the index.test.ts file. For testing, this repo works with Jest.

Thank you for helping us build a better categorization for the world :)

Dev Features

  • Testing with Jest
  • Linting out of the box (checks the style of your code), with TSLint
  • Build, prepublish and other scripts to help you to develop
  • Works with Typescript: Static typing for your JS Applications, reducing amount of runtime errors
  • Coverage out of the box, thanks to Jest
  • Uses deterministic module resolving, with Yarn

Credits

Developed by Juan Camilo Guarín Peñaranda,
Otherwise SAS, Colombia
2017

License

MIT.