{"id":30760751,"url":"https://github.com/jansim/nicknames","last_synced_at":"2025-09-04T13:49:48.689Z","repository":{"id":309805403,"uuid":"1037553687","full_name":"jansim/nicknames","owner":"jansim","description":"Specify human readable names for the columns in your data once and then reuse them across your project to rename plots axes, dataframe columns, tables and anything else.","archived":false,"fork":false,"pushed_at":"2025-08-25T16:55:10.000Z","size":3547,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-25T18:09:07.665Z","etag":null,"topics":["data-cleaning","data-visualization","r","r-package"],"latest_commit_sha":null,"homepage":"http://simson.io/nicknames/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jansim.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-08-13T18:45:28.000Z","updated_at":"2025-08-25T16:49:21.000Z","dependencies_parsed_at":"2025-08-13T23:26:57.616Z","dependency_job_id":"f7655c84-a73b-46db-bfb2-5c67b16615e7","html_url":"https://github.com/jansim/nicknames","commit_stats":null,"previous_names":["jansim/nicknames"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jansim/nicknames","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jansim%2Fnicknames","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jansim%2Fnicknames/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jansim%2Fnicknames/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jansim%2Fnicknames/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jansim","download_url":"https://codeload.github.com/jansim/nicknames/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jansim%2Fnicknames/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273619670,"owners_count":25138238,"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-09-04T02:00:08.968Z","response_time":61,"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":["data-cleaning","data-visualization","r","r-package"],"created_at":"2025-09-04T13:49:45.579Z","updated_at":"2025-09-04T13:49:48.674Z","avatar_url":"https://github.com/jansim.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# nicknames \u003cimg src=\"man/figures/logo.svg\" width=\"120\" align=\"right\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/jansim/nicknames/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/jansim/nicknames/actions/workflows/R-CMD-check.yaml)\n\u003c!-- badges: end --\u003e\n\nNicknames allows you to specify human readable names for the columns in your data once and then reuse them across your project to rename plots axes, dataframe columns, tables and anything else.\n\n## Installation\n\nYou can install the development version of nicknames from [GitHub](https://github.com/) with:\n\n``` r\n# install.packages(\"pak\")\npak::pak(\"jansim/nicknames\")\n```\n\n## Example\n\nWith nicknames, you can register the mapping between columns in your data and human readable column names once and easily re-use them everywhere.\n\n```{r ex-setup}\nlibrary(nicknames)\n\nnn_register(c(\n  \"mpg\" = \"Miles per Gallon\",\n  \"hp\" = \"Horsepower\",\n  \"cyl\" = \"Number of\\nCylinders\"\n))\n```\n\nIncluding ggplot2 plots...\n\n```{r ex-ggplot, fig.height=3, fig.width=7}\nlibrary(ggplot2)\n\n# Create plot and apply nickname labels\nggplot(mtcars, aes(x = mpg, y = hp, color = factor(cyl))) +\n  geom_point() +\n  labs_nn()\n```\n\n...dataframes...\n\n```{r ex-df, message=FALSE}\nlibrary(dplyr)\n\nmtcars |\u003e\n  select(mpg, hp, cyl) |\u003e\n  nn() |\u003e\n  head()\n```\n\n...and column names directly.\n\n```{r ex-char}\nnn(\"mpg\")\n```\n\nWhile variables names are extracted from within function calls (e.g. `factor(cyl)` above), more exact matches take priority if you need to be precise.\n\n```{r ex-ggplot-exact, fig.height=3, fig.width=7}\nnn_register(c(\n  \"factor(cyl)\" = \"Number of\\nCylinders (factor)\"\n))\n\nggplot(mtcars, aes(x = mpg, y = hp, color = factor(cyl))) +\n  geom_point() +\n  labs_nn()\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjansim%2Fnicknames","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjansim%2Fnicknames","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjansim%2Fnicknames/lists"}