{"id":22713563,"url":"https://github.com/program--/plannr","last_synced_at":"2025-07-03T20:35:03.352Z","repository":{"id":107794173,"uuid":"301913293","full_name":"program--/plannr","owner":"program--","description":"R :package: for parsing Microsoft Planner data via exported Excel spreadsheets.","archived":false,"fork":false,"pushed_at":"2021-03-17T05:00:55.000Z","size":684,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-01T05:17:24.308Z","etag":null,"topics":["microsoft","package","planner","plannr","r"],"latest_commit_sha":null,"homepage":"https://plannr.justinsingh.me","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/program--.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2020-10-07T03:05:43.000Z","updated_at":"2022-10-20T14:32:53.000Z","dependencies_parsed_at":"2023-05-21T09:45:36.092Z","dependency_job_id":null,"html_url":"https://github.com/program--/plannr","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/program--/plannr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/program--%2Fplannr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/program--%2Fplannr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/program--%2Fplannr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/program--%2Fplannr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/program--","download_url":"https://codeload.github.com/program--/plannr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/program--%2Fplannr/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263401057,"owners_count":23461027,"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","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":["microsoft","package","planner","plannr","r"],"created_at":"2024-12-10T14:09:32.915Z","updated_at":"2025-07-03T20:35:03.307Z","avatar_url":"https://github.com/program--.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# plannr \u003ca href=\"https://plannr.justinsingh.me\"\u003e\u003cimg src=\"man/figures/logo.png\" alt=\"R Planner Parser\" width=25% align=\"right\" /\u003e\u003c/a\u003e\n\n[![Build Status](https://travis-ci.org/program--/plannr.svg?branch=master)](https://travis-ci.org/program--/plannr)\n[![Codecov test coverage](https://codecov.io/gh/program--/plannr/branch/master/graph/badge.svg)](https://codecov.io/gh/program--/plannr?branch=master)\n[![Project Status: Inactive – The project has reached a stable, usable state but is no longer being actively developed; support/maintenance will be provided as time allows.](https://www.repostatus.org/badges/latest/inactive.svg)](https://www.repostatus.org/#inactive)\n\n**plannr** is an in-development package used for parsing **Microsoft Planner** data into R via\nexported *Excel* spreadsheets for easy usage and creation of beautiful **ggplot2** or **plotly** visuals.\n\nUsage of plannr is fairly simple:\n\n1. Open your planner in the Microsoft Planner web application.\n2. Export plan to Excel (as `.xlsx`).\n3. Read using plannr's `read_planner()` function.\n\nNow you have your Planner data imported into **R** as a `plannr` object!\n\n## Installation\nTo install the developmental version:\n\n```r\nremotes::install_github(\"program--/plannr\")\n```\n\n## Plotting with plannr\nUsing the `plot_planner()` function, you can quickly create a **donut chart** using `ggplot` or `plotly` to your specifications. `plot_planner()` supports filtering by:\n\n- `tasks` - Tasks (w/o Checklists)\n- `checklists` - Tasks (w/ Checklists)\n- `priority` - Priority\n- `late` - Late Tasks\n- `assigned_to` - Assigned To\n- `completed_by` - Completed By\n\n### Examples:\n\n**Plannr Object Summary**\n\n```r\nplan_xlsx \u003c- read_planner(\"path/to/planner.xlsx\")\n\nsummary(plan_xlsx)\n\n# Return:\n# =======\u003e\u003e PLANNER \u003c\u003c=======\n#    Plan Name: Example Plan\n#  Export Date: 01/01/1234\n# ========\u003e\u003e TASKS \u003c\u003c========\n#       Total: 32 Tasks\n#   Completed: 4    (12.50%)\n# In Progress: 5    (15.62%)\n# Not Started: 23   (71.88%)\n# ===\u003e\u003e CHECKLIST TASKS \u003c\u003c===\n#       Total: 57 Tasks\n#   Completed: 0    (0.00%)\n# Not Started: 57   (100.00%)\n# ===========================\n```\n\n**Basic Plotting**\n\n```r\n# Print a donut plot taking into account checklists on tasks\nplan_xlsx \u003c- read_planner(\"path/to/planner.xlsx\")\n\nplot_planner(plan_xlsx, by = \"checklists\")\n```\n\n![](man/figures/example_ggplot.png)\n\n**Getting *filtered* plot data**\n\n```r\n# Return a easy-plottable-tibble of the planner data filtered by priority\nplot_planner(plan_xlsx, by = \"priority\", data_only = TRUE)\n```\n\n**Extending with `ggplot`**\n\n```r\n# Easy customizability via `plot_type = \"basic\"` argument.\n# Which, returns a ggplot() object of the planner data without\n# anything additional.\n#\n# labs() parameters can be added to the end of the argument list\n# for plot_planner() calls.\nplot_planner(\n    plan_xlsx,\n    by = \"tasks\",\n    plot_type = \"basic\",\n    title = \"Tasks Progress\"\n) +\ngeom_bar() +\ntheme_bw() +\ntheme(\n    legend.position = \"none\"\n)\n```\n\n**Interactive plots with `plotly`**\n\n```r\nplot_planner(\n    plan_xlsx,\n    by = \"checklists\",\n    interactive = TRUE\n)\n```\n\n## Using `dplyr` with Planner data\n\nCurrently there's two supported ways of using `dplyr` functions via plannr.\n\n1. Using `filter_planner()` for `dplyr::filter()`.\n2. Using `plot_planner(..., data_only = TRUE, ...)` with `magrittr` piping.\n\n## Documentation\n\nYou can view the documentation here: [https://plannr.justinsingh.me](https://plannr.justinsingh.me).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogram--%2Fplannr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprogram--%2Fplannr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogram--%2Fplannr/lists"}