{"id":13689040,"url":"https://github.com/rossmacarthur/emojis","last_synced_at":"2025-10-06T16:03:16.372Z","repository":{"id":57624856,"uuid":"345073865","full_name":"rossmacarthur/emojis","owner":"rossmacarthur","description":"✨ Lookup emoji in O(1) time, access metadata and GitHub shortcodes, iterate over all emoji","archived":false,"fork":false,"pushed_at":"2025-08-12T18:40:22.000Z","size":944,"stargazers_count":72,"open_issues_count":2,"forks_count":10,"subscribers_count":1,"default_branch":"trunk","last_synced_at":"2025-10-06T16:03:11.359Z","etag":null,"topics":["crate","emoji","gemoji","unicode"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rossmacarthur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-03-06T11:13:12.000Z","updated_at":"2025-08-12T18:43:18.000Z","dependencies_parsed_at":"2024-06-21T04:20:05.160Z","dependency_job_id":"97ca2737-559c-49ed-a584-71a2bbf84690","html_url":"https://github.com/rossmacarthur/emojis","commit_stats":{"total_commits":81,"total_committers":3,"mean_commits":27.0,"dds":"0.024691358024691357","last_synced_commit":"3cb635d7a4eca5376cb15d85dd8b76d978953eeb"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/rossmacarthur/emojis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rossmacarthur%2Femojis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rossmacarthur%2Femojis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rossmacarthur%2Femojis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rossmacarthur%2Femojis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rossmacarthur","download_url":"https://codeload.github.com/rossmacarthur/emojis/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rossmacarthur%2Femojis/sbom","scorecard":{"id":785244,"data":{"date":"2025-08-11","repo":{"name":"github.com/rossmacarthur/emojis","commit":"e6b50f5709ed4dca1213c5eafb8bf1e9a13828e8"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 1/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":10,"reason":"16 commit(s) and 7 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yaml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:64: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:65: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:83: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:93: update your workflow using https://app.stepsecurity.io/secureworkflow/rossmacarthur/emojis/build.yaml/trunk?enable=pin","Info:   0 out of   5 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   6 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE-APACHE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE-APACHE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'trunk'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/build.yaml:73"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-23T05:55:38.202Z","repository_id":57624856,"created_at":"2025-08-23T05:55:38.202Z","updated_at":"2025-08-23T05:55:38.202Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278638111,"owners_count":26019943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crate","emoji","gemoji","unicode"],"created_at":"2024-08-02T15:01:31.495Z","updated_at":"2025-10-06T16:03:16.365Z","avatar_url":"https://github.com/rossmacarthur.png","language":"Rust","funding_links":[],"categories":["emoji","Rust"],"sub_categories":[],"readme":"\u003c!-- Generated by cargo-onedoc v0.3.2. DO NOT EDIT. --\u003e\n\n# emojis\n\n[![Crates.io Version](https://badgers.space/crates/version/emojis)](https://crates.io/crates/emojis)\n[![Docs.rs Latest](https://badgers.space/badge/docs.rs/latest/blue)](https://docs.rs/emojis)\n[![Build Status](https://badgers.space/github/checks/rossmacarthur/emojis?label=build)](https://github.com/rossmacarthur/emojis/actions/workflows/build.yaml)\n\n✨ Lookup emoji in *O(1)* time, access metadata and GitHub shortcodes,\niterate over all emoji.\n\n## Features\n\n- Lookup up emoji by Unicode value\n- Lookup up emoji by GitHub shortcode ([gemoji] v4.1.0)\n- Access emoji metadata: name, unicode version, group, skin tone, [gemoji] shortcodes\n- Iterate over emojis in Unicode CLDR order\n- Iterate over emojis in an emoji group, e.g. “Smileys \u0026 Emotion” or “Flags”\n- Iterate over the skin tones for an emoji\n- Select a specific skin tone for an emoji\n- Uses [Unicode v16.0](https://unicode.org/emoji/charts-16.0/emoji-released.html) emoji specification\n\n## Getting started\n\nFirst, add the `emojis` crate to your Cargo manifest.\n\n```sh\ncargo add emojis\n```\n\nSimply use the [`get()`][get] function to lookup emojis by Unicode value.\n\n```rust\nlet rocket = emojis::get(\"🚀\").unwrap();\n```\n\nOr the [`get_by_shortcode()`][get_by_shortcode] function to lookup emojis by\n[gemoji] shortcode.\n\n```rust\nlet rocket = emojis::get_by_shortcode(\"rocket\").unwrap();\n```\n\nThese operations take *Ο(1)* time.\n\n## MSRV\n\nCurrently the minimum supported Rust version is 1.61 due to the dependency\non `phf`. The policy of this crate is to only increase the MSRV in a\nbreaking release.\n\n## Breaking changes\n\nWhen [gemoji] or the Unicode version is upgraded this is not considered a\nbreaking change, instead you should make sure to use\n[`unicode_version()`][unicode_version] to filter out newer versions.\n\n## Examples\n\nSee [examples/replace.rs] for an example that replaces `:gemoji:` names with\nreal emojis in text.\n\n```sh\n$ echo \"launch :rocket:\" | cargo run --example replace\nlaunch 🚀\n```\n\n[`get()`][get] and [`get_by_shortcode()`][get_by_shortcode] return an\n[`Emoji`][Emoji] struct which contains various metadata regarding the emoji.\n\n```rust\nlet hand = emojis::get(\"🤌\").unwrap();\nassert_eq!(hand.as_str(), \"\\u{1f90c}\");\nassert_eq!(hand.as_bytes(), \u0026[0xf0, 0x9f, 0xa4, 0x8c]);\nassert_eq!(hand.name(), \"pinched fingers\");\nassert_eq!(hand.unicode_version(), emojis::UnicodeVersion::new(13, 0));\nassert_eq!(hand.group(), emojis::Group::PeopleAndBody);\nassert_eq!(hand.skin_tone(), Some(emojis::SkinTone::Default));\nassert_eq!(hand.shortcode(), Some(\"pinched_fingers\"));\n```\n\nUse [`skin_tones()`][skin_tones] to iterate over the skin tones of an\nemoji.\n\n```rust\nlet raised_hands = emojis::get(\"🙌🏼\").unwrap();\nlet skin_tones: Vec\u003c_\u003e = raised_hands.skin_tones().unwrap().map(|e| e.as_str()).collect();\nassert_eq!(skin_tones, [\"🙌\", \"🙌🏻\", \"🙌🏼\", \"🙌🏽\", \"🙌🏾\", \"🙌🏿\"]);\n```\n\nYou can use the `iter()` function to iterate over all emojis. This only\nincludes the default skin tone versions.\n\n```rust\nlet faces: Vec\u003c_\u003e = emojis::iter().map(|e| e.as_str()).take(5).collect();\nassert_eq!(faces, [\"😀\", \"😃\", \"😄\", \"😁\", \"😆\"]);\n```\n\nIt is recommended to filter the list by the maximum Unicode version that you\nwish to support.\n\n```rust\nlet iter = emojis::iter().filter(|e| {\n    e.unicode_version() \u003c emojis::UnicodeVersion::new(13, 0)\n});\n```\n\nUsing the `Group` enum you can iterate over all emojis in a group.\n\n```rust\nlet fruit: Vec\u003c_\u003e = emojis::Group::FoodAndDrink.emojis().map(|e| e.as_str()).take(5).collect();\nassert_eq!(fruit, [\"🍇\", \"🍈\", \"🍉\", \"🍊\", \"🍋\"]);\n```\n\n#### Storing the [`Emoji`][Emoji] type\n\nIf you want to store the [`Emoji`][Emoji] type in a data structure, you should\nstore it as static reference: `\u0026'static Emoji`. This crate intentionally\ndoes not provide any constructors or implement `Clone` or `Copy` for\n[`Emoji`][Emoji]. `\u0026'static Emoji` supports `serde` serialization and\ndeserialization, *not* `Emoji`.\n\nFor example:\n\n```rust\n#[derive(Debug, Clone, Copy, serde::Serialize, serde::Deserialize)]\nenum Example {\n    Rocket {\n        value: \u0026'static emojis::Emoji\n    },\n}\n\nExample::Rocket { value: emojis::get(\"🚀\").unwrap() };\n```\n\n[gemoji]: https://github.com/github/gemoji\n[get]: https://docs.rs/emojis/latest/emojis/fn.get.html\n[get_by_shortcode]: https://docs.rs/emojis/latest/emojis/fn.get_by_shortcode.html\n[unicode_version]: https://docs.rs/emojis/latest/emojis/struct.Emoji.html#method.unicode_version\n[examples/replace.rs]: https://github.com/rossmacarthur/emojis/blob/trunk/examples/replace.rs\n[Emoji]: https://docs.rs/emojis/latest/emojis/struct.Emoji.html\n[skin_tones]: https://docs.rs/emojis/latest/emojis/struct.Emoji.html#method.skin_tones\n\n## License\n\nThis project is distributed under the terms of both the MIT license and the Apache License (Version 2.0).\n\nSee [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frossmacarthur%2Femojis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frossmacarthur%2Femojis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frossmacarthur%2Femojis/lists"}