Skip to content

PowerShell module that enables you to search, discover, and retrieve emoji Unicode info directly through the command line.

License

Notifications You must be signed in to change notification settings

techthoughts2/pwshEmojiExplorer

Repository files navigation

pwshEmojiExplorer

Minimum Supported PowerShell Version PowerShell Gallery Cross Platform License Documentation Status

pwshEmojiExplorer Logo

Branch Windows - PowerShell Windows - pwsh Linux MacOS
main Build Status Windows PowerShell main Build Status Windows pwsh main Build Status Linux main Build Status MacOS main
Enhancements Build Status Windows PowerShell Enhancements Build Status Windows pwsh Enhancements Build Status Linux Enhancements Build Status MacOS Enhancements

Synopsis

pwshEmojiExplorer is a PowerShell module designed to enable users to search, discover, and retrieve emojis directly through the command line. Leveraging the extensive Unicode emoji library, the module offers a streamlined approach to exploring and integrating a vast range of emojis into various coding projects.

Description

This PowerShell module simplifies the process of finding and using emojis by enabling direct command-line searches. It's not just about bringing emojis into PowerShell scripts; it's about providing a solution for handling emojis in various coding projects. Whether you need the HTMLEntityFormat for a web project, a Unicode representation for a text file, or the hex code for a development task, pwshEmojiExplorer provides this information quickly and efficiently. It's a tool for developers, scripters, and digital creators who seek to incorporate emojis into their work more effectively, enhancing the ease of access and use of emojis in diverse digital contexts.

Features

  • Extensive Emoji Search: Find emojis by name, category, code point, and more.
  • Emoji Information Retrieval: Get detailed information about each emoji, including different representations and formats.
  • Text Enhancement: Automatically enhance texts by adding or replacing words with emojis. Experimental, but perfect for adding a bit of fun to your scripts.
  • Unicode Compliance: Utilizes the Public data set from the Unicode Data Files, ensuring that you are working with officially recognized emoji standards and variations.
  • Auto-updating: Actively scans for updates in the Unicode data set and automatically upgrades to the latest published standard. This feature ensures you are aligned with the newest emoji releases and changes in the Unicode standard.

Getting Started

Documentation

Documentation for pwshEmojiExplorer is available at: https://pwshEmojiExplorer.readthedocs.io

Installation

Install-Module -Name 'pwshEmojiExplorer' -Repository PSGallery -Scope CurrentUser

Quick Start

#-------------------------------------------------------------------------------------
# Import the pwshEmojiExplorer module
Import-Module -Name 'pwshEmojiExplorer'
#-------------------------------------------------------------------------------------
# Get detailed information about a specific emoji by its character
Get-Emoji -Emoji 'πŸ˜€'
#-------------------------------------------------------------------------------------
# Retrieve a list of all emojis within the 'Food & Drink' group
Get-Emoji -Group 'Food & Drink'
#-------------------------------------------------------------------------------------
# Retrieve a list of all emojis within the 'food-vegetable' sub-group
Get-Emoji -SubGroup 'food-vegetable'
#-------------------------------------------------------------------------------------
# Find an emoji based on its shortcode πŸ₯°
Get-Emoji -ShortCode ':smiling_face_with_hearts:'
#-------------------------------------------------------------------------------------
# Get information about an emoji using its hex code, like '1F600' for πŸ˜€
Get-Emoji -HexCodePoint '1F600'
#-------------------------------------------------------------------------------------
# Retrieve an emoji by specifying its decimal code point, e.g., 128512 for πŸ˜€
Get-Emoji -Decimal 128512
#-------------------------------------------------------------------------------------
# Perform a general search for emojis
Get-Emoji -SearchTerm 'fork'
#-------------------------------------------------------------------------------------
# Retrieve the complete list of available emojis
Get-AllEmoji
#-------------------------------------------------------------------------------------
# Enhance a given text by automatically adding relevant emojis
$sampleText = "I am going to the airport tomorrow to fly on a plane to Spain. Before I take off I'm going to eat some food. I've heard they have good restaurants at the terminal. Hopefully they have something spicy. You know how much I like hot food! I'm so excited to see you! Can't wait to see you! Love you!"
Add-EmojiToText -Text $sampleText
#-------------------------------------------------------------------------------------

Notes

This PowerShell project was created with Catesta.

Contributing

If you'd like to contribute to pwshEmojiExplorer, please see the contribution guidelines.

License

This project is licensed under the MIT License.