Standup Generator

An easy way to create .txt files to keep track of your daily standups for team meetings

Contents 1. Description 2. Inspiration 3. Requirements 4. Installation 5. Features 6. Usage 7. Code Examples 8. Testing 9. Future Goals

Description

Standup Generator is a module for creating and editing standup files. It is a Perl package for use on a MacOS computer via a CLI configured to work with either zsh or bash. It contains three main methods: one for creating a new standup .txt file, based on whatever the previous standup file contained; another for opening standup files in your default text editor; and a final one for viewing all the standup files from the past week. It also includes a helper method that you can execute via the CLI to update your config files with shortcuts to enable you to execute those main methods with less typing on your end.

Inspiration

I like to type out my standups before delivering them in my team's daily morning meetings. Otherwise, I'll just end up rambling, and I'll often forget to include an important element. After creating basic .txt files for my standups over the course of a few weeks, I found that the files turned into ad hoc to-do lists that helped me stay on track with my work. However, creating those files from scratch every day was inefficient, so I came up with some bash scripts to streamline the process. As always, I soon realized that I could still factor out more inefficiencies. At that point, I decided to switch to a more robust scripting language that I could use to create a package that I could publish in case other people wanted to use my same shortcuts. I started playing around with Perl, and this package is the result. While it's only in a rudimentary stage and could still be improved upon (see Future Goals below), I think it's adequate for basic usage.

Requirements

Installation

Since this package has not yet been published on CPAN, you will need to use a clone of this repo. Ensure you already have Perl on your local computer. (You can check this by executing perl -v.)

  1. Fork this repository
  2. Clone it to your local computer
  3. Execute any of the methods from this package from within your local version of the directory with a version of this command:

perl -Ilib -e 'require "./lib/StandupGenerator.pm"; StandupGenerator::create_standup("/Users/johndoe/projects/super-important-project/standups")'

Replace create_standup with whichever top-level method you want to use, and replace the inner string with the full file path to the directory in which you plan to store standups.

Features

Usage

Short Approach

After downloading the package, execute a version of the following command to automatically add the below shortcuts to your zsh or bash config file.

perl -Ilib -e 'require "./lib/StandupGenerator.pm"; StandupGenerator::set_aliases("/Users/johndoe/projects/super-important-project/standups")'

Replace the inner string with the exact path to the directory you plan to use to store your standups.

You can execute this command multiple times to reset the directory for your standups. For instance, after completing a project but before starting another, you would want to reset the directory to the directory for the new project. Each time you execute the command, three new functions will be added to the bottom of your zsh or bash config file. As a result, if you generate aliases on five different occassions, your zsh or bash config file will now have 15 different functions at the end of its file. Later commands always override earlier, identical commands, so this won't affect its ability to operate. However, feel free to delete older instances of the shortcuts as you see fit. Always make sure the directory you select will only contain standup files.

csu

This method creates a new stand*up. It is a shortcut for the create_standup method. It takes no arguments. It will create the file in the appropriate folder, then open it in your default text editor (e.g., TextEdit). If yesterday's standup was *s2d07.txt, then to create and open s2d08.txt, merely run:

csu

osu

This method opens an existing stand*up. It is a shortcut for the open_standup method. It takes two arguments: a number for the sprint and two-digit string for the day. It will open the corresponding file from the already aliased folder in your default text editor (e.g., TextEdit). If you want to open *s1d03.txt, then merely run:

osu 1 '03'

wsu

This method opens all of this past week's stand*ups. It is a shortcut for the view_standups_from_week method. It takes no arguments. It will open six files from the already aliased folder in your default text editor (e.g., TextEdit). The files will be for the standups from Monday through Friday of the week in question, along with the following Monday's. It determines which files to open based on the last file in the directory, which it uses to determine the likely week. If it's Friday and you have already preemptively created this coming Monday's standup, which happens to be *s4d09.txt, then you can open s4d04.txt, s4d05.txt, s4d06.txt, s4d07.txt, s4d08.txt, and s4d09.txt by merely running:

wsu

Long Approach

If you don't want your config files edited and are fine with writing out long commands evertime, you can instead use the full commands.

Execute any of the methods from this package with a version of this command:

perl -Ilib -e 'require "./lib/StandupGenerator.pm"; StandupGenerator::create_standup("/Users/johndoe/projects/super-important-project/standups")'

Replace create_standup with whichever top-level method you want to use, and replace the inner string with the full file path to the directory in which you plan to store standups. Make sure you include all necessary parameters for the method you wish to use.

Recommendation

Use the short approach. Let's say you have a new project called Project Ultra. You have a directory on you computer called project-ultra to house all materials related to this project. Here's how to use the Standup Generator.

  1. Create a directory within project-ultra that will only hold the standup files; call it standups for simplicity
  2. Install the package using the instructions above
  3. Execute the initial Perl script indicated in the Short Approach section to generate the aliases (adjust the file path accordingly)
  4. Create the first standup for this project by running csu
  5. Fill in data about what you did yesterday, what you plan to do today, and what blockers you currently have in their respective sections
  6. When you need to create the standup for tomorrow, merely run csu again; note that the content from yesterday's standup's Today section will be stored in the new standup's Yesterday and Today sections, and that yesterday's blockers will be mapped over to today's (under the assumption that this will probably be a time-saving hack)
  7. If you ever need to view an earlier standup, use the osu shortcut; for instance, if on Thursday you want to view your standup from Tuesday, execute osu 1 '02'
  8. At the end of the week, if you want to see all your standups for the past week, just run wsu; this is helpful if you need to fill in your activities on your timesheet for work

Code Examples

Helper function to find the last file in a directory ```perl sub find_last_file { my ($path) = @; opendir my $dir, $path; my @files = readdir $dir; closedir $dir; my @sorted = sort @files; my $fileslength = scalar(@files); my $last_file = $sorted[$files_length - 1];

if (index($last_file, '.txt') == -1) {
    $last_file = 's0d0.txt';
}

return $last_file;

} ```

Open a file via the system command based on specific parameters perl sub open_one { my ($path, $sprint, $day) = @_; my $command = "open ${path}/s${sprint}d${day}.txt"; system($command); }

Testing

This repository uses the Test::Simple module for testing, which should come bundled with Perl by default. Tests are spread across 8 files within the t directory. To run all tests within a file, execute a version of this command:

perl -Ilib t/routines/create_new.t

Adjust file path appropriately.

Future Goals