| Name | kettlebells JSON |
| Version |
0.2.42
JSON |
| download |
| home_page | None |
| Summary | A CLI tool to create, save, and track progress of kettlebell workouts. |
| upload_time | 2025-02-08 18:05:37 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | None |
| keywords |
cli
fitness
kettlebells
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Table of Contents
1. [Installation](#orgc30a08d)
1. [uv](#org644f9b3)
2. [pipx](#org3e526d7)
2. [Usage](#org61925e3)
1. [Initialize](#org9dc1f6a)
2. [Update Exercises](#orgf9f1c9d)
3. [Commands](#org6ca217f)
1. [save](#orgaa12efc)
2. [random](#orgfe3c69f)
3. [last](#org319bbb1)
4. [view](#orgb4c7591)
5. [stats](#org85a8277)
kettlebells is a CLI designed to create, save, and track the progress of kettlebell workouts. The inspiration for this project came from [Pat Flynn’s conversation with Bret Jones](https://www.chroniclesofstrength.com/what-strength-aerobics-are-and-how-to-use-them-w-brett-jones/). (For a more detailed look at Iron Cardio, go checkout the [Iron Cardio Book](https://strongandfit.com/products/iron-cardio-by-brett-jones) by Bret Jones.) After starting an [initial project](https://github.com/rhelmstedter/iron-cardio) that focused only on iron cardio, I wanted to be able to add more. This is essentially a fork of the iron-cardio project designed to add various workouts such as the armor building complex, and dry fighting weight.
As of version 0.2.1, the way workouts are constructed has completely changed. This will allow users to construct their own custom workouts in the future. It will also allow the stats to keep track of how many reps of each type of exercise have been done.
<a id="orgc30a08d"></a>
# Installation
<a id="org644f9b3"></a>
## [uv](https://github.com/astral-sh/uv)
uv tool install kettlebells
<a id="org3e526d7"></a>
## [pipx](https://github.com/pypa/pipx)
pipx install kettlebells
<a id="org61925e3"></a>
# Usage
<a id="org9dc1f6a"></a>
## Initialize
Run the `init` command to create the database.
kettlebells init
Next, run the `setloads` command. This sets the units to either pounds (lbs) or kilograms (kg), the user’s bodyweight, and the loads for the light, medium, and heavy kettlebell. This command can be run as needed when the user is ready to move up in load or bodyweight changes.
kettlebells setloads
<a id="orgf9f1c9d"></a>
## Update Exercises
Occasionally, new exercises are added to the database. If you have already initialized in a previous version, run the `update` command.
kettlebells update
<a id="org6ca217f"></a>
## Commands
<a id="orgaa12efc"></a>
### save
The `save` command saves workouts to the database. The current options are:
- [ic](#org119a057)
- [abc](#orgeaf2c20)
- [btb](#org251f683)
- [dfw](#orgfdfc716)
- [pw](#orga37f1b5)
- [rop](#orgbb8663a)
- [wolf](#org264a3d2)
- [custom](#org5463923)
When run with no option, the `save` command will attempt to use the most recently generated random workout. Otherwise, use the `--workout-type` option to manually enter a workout, e.g.:
kettlebells save --workout-type abc
1. dfw
When the `save` command is run with the workout type of `dfw`, a dry fighting weight workout is saved. See [the original post](https://www.strongfirst.com/dry-fighting-weight/) for more details
kettlebells save --workout-type dfw
2. btb
The save command with a workout type of `btb` allows the user to save a Back to Basics Workout. These workouts are constructed based on The Pat Flynn Show episode with Dan John [The BEST Kettlebell Program for GEGINNERS | THE BTBKP](https://patflynnshow.libsyn.com/the-best-kettlebell-program-for-beginners-the-btbkp). The choices are ladders of 2-3-5 clean and presses followed by either snatches or double front squats. The warm up and cool exercises are not included in the workout.
kettlebells save --workout-type btb
The program options are:
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup>
<col class="org-left" />
<col class="org-left" />
</colgroup>
<thead>
<tr>
<th scope="col" class="org-left">First block</th>
<th scope="col" class="org-left">Second Block</th>
</tr>
</thead>
<tbody>
<tr>
<td class="org-left">2 ladders</td>
<td class="org-left">60 Snatches</td>
</tr>
<tr>
<td class="org-left">3 ladders</td>
<td class="org-left">80 Snatches</td>
</tr>
<tr>
<td class="org-left">5 ladders</td>
<td class="org-left">100 Snatches</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left">2 ladders</td>
<td class="org-left">10 sets of 5 Double Front Squats</td>
</tr>
<tr>
<td class="org-left">3 ladders</td>
<td class="org-left">10 sets of 5 Double Front Squats</td>
</tr>
<tr>
<td class="org-left">5 ladders</td>
<td class="org-left">10 sets of 5 Double Front Squats</td>
</tr>
</tbody>
</table>
3. pw
The save command with a workout type of `pw` saves versions of [Dan John’s Perfect Workout](https://youtu.be/aHQLx_HhFqo?si=b68xBn41-tcGDVJE). While in the video Dan does hip thrusts until it burns, for ease of recording the workout, `kettlebells` offers a set number of reps for the hip thrust.
kettlebells save --workout-type pw
The program options are:
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup>
<col class="org-left" />
<col class="org-left" />
<col class="org-right" />
<col class="org-right" />
</colgroup>
<thead>
<tr>
<th scope="col" class="org-left">Variation</th>
<th scope="col" class="org-left">Exercises</th>
<th scope="col" class="org-right">Sets</th>
<th scope="col" class="org-right">Reps</th>
</tr>
</thead>
<tbody>
<tr>
<td class="org-left"><b>Original</b></td>
<td class="org-left">Half-kneeling Press</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Hanging Leg Raise</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Banded Hip Thrust</td>
<td class="org-right">3</td>
<td class="org-right">15</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Bulgarian Goat Bag Swing</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Goblet Squat / Broomstick Overhead Squat</td>
<td class="org-right">1</td>
<td class="org-right">8</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>Indoor</b></td>
<td class="org-left">Half-kneeling Press</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Child’s Pose</td>
<td class="org-right">3</td>
<td class="org-right">20 secs</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Hip Thrust / Clam Shell (15, 14, 13…)</td>
<td class="org-right">1</td>
<td class="org-right">120</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Goblet Squat / Broomstick Overhead Squat</td>
<td class="org-right">1</td>
<td class="org-right">8</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>The Bull</b></td>
<td class="org-left">Half-kneeling Press</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Hanging Leg Raise</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Bulgarian Goat Bag Swing</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Bent Over Rows</td>
<td class="org-right">3</td>
<td class="org-right">8</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Goblet Squat / Broomstick Overhead Squat</td>
<td class="org-right">1</td>
<td class="org-right">8</td>
</tr>
</tbody>
</table>
4. rop
The save command with a workout type of `rop` saves versions of Pavel Tsatsouline’s rite of passage program from [Enter The Kettlebell](https://www.amazon.com/Enter-Kettlebell-Strength-Secret-Supermen/dp/1942812132). The clean and press and pullups are calculated as ladders, while the swings and snatches are straight sets.
kettlebells save --workout-type rop
5. wolf
The save command with a workout type of `wolf` saves workouts from the free program [The Wolf](https://chasingstrength.com/reports/double-kettlebell-complex/) from [Geoff Neupert](https://chasingstrength.com). This is a gasser for sure.
kettlebells save --workout-type wolf
6. custom
When the `save` command is run with the workout type of `custom`, the user can save a custom workout. Custom workouts need a `workout_type` and a `variation`. The default is `custom`. Exercises are chosen via [iterfzf](https://github.com/dahlia/iterfzf). Select `Other` to add a custom exercise. Select `Done` or press escape when finished adding all the exercises.
kettlebells save --workout-type custom
1. Reps and Loads for Custom Exercises
Unilateral exercises such as the single arm overhead press (simply “Press” in the program) should have the reps doubled. For example, if the set and rep scheme is 3 sets of 8 single arm overhead presses on the left and right arm, that should be saved as 16 reps per set for that exercise.
When the stats are calculated, any exercise that has “Double” in it has the load multiplied by 2. So Double Pressing a pair of 24 kg kettlebells should be saved as a load of 24 kg, but the calculations will result in 48 kg per rep. If using uneven sized bells, use the average weight of the two bells rounded to the nearest integer.
2. Suggested Use for Complexes
Consider a workout out like the [8 - 5 - 3 Rep Scheme](https://www.youtube.com/watch?v=nHPfglRCp6M&t=13s) from Pat Flynn. The `workout_type` would be “complex”, the `variation` would be “8-5-3 Rep Scheme”. Technically, a set consists of 8 Goblet Squats, 5 Start Stop Swings, 3 Push-ups. Then you would repeat this for 5 rounds. However, in `kettlebells` the user will add each exercise separately. So the Goblet Squat would be 5 sets of 8. The Start Stop Swing would be 5 sets of 5, and the Push-up would be 5 sets of 3.
<a id="orgfe3c69f"></a>
### random
The work out command generates a random workout. The current options are:
- `ic` (Iron Cardio)
- `abc` (Armor Building Complex)
1. iron-cardio
The `random` command with a workout type of `ic`, generates a random iron cardio workout.
kettlebells random --workout-type ic
Iron cardio workouts are built from the following parameters:
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup>
<col class="org-left" />
<col class="org-left" />
</colgroup>
<thead>
<tr>
<th scope="col" class="org-left">Parameter</th>
<th scope="col" class="org-left">Options</th>
</tr>
</thead>
<tbody>
<tr>
<td class="org-left"><b>Single Bell Variations</b></td>
<td class="org-left">Classic</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Classic + Pull-up</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Classic + Snatch</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Traveling 2s</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>Double Bell Variations</b></td>
<td class="org-left">Double Classic</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Double Classic + Pull-up</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">Double Traveling 2s</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>TIMES</b></td>
<td class="org-left">30 mins</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">20 mins</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">10 mins</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>LOADS</b></td>
<td class="org-left">heavy</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">medium</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">light</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>SWINGS</b></td>
<td class="org-left">0 - 150</td>
</tr>
</tbody>
</table>
2. abc
The random command with a workout type of `abc` will generate a random armor building complex workout.
kettlebells random --workout-type abc
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup>
<col class="org-left" />
<col class="org-left" />
</colgroup>
<thead>
<tr>
<th scope="col" class="org-left">Parameter</th>
<th scope="col" class="org-left">Options</th>
</tr>
</thead>
<tbody>
<tr>
<td class="org-left"><b>Single Bell Variations</b></td>
<td class="org-left">Armor Building Complex 2.0</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>Double Bell Variations</b></td>
<td class="org-left">Armor Building Complex</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>TIMES</b></td>
<td class="org-left">30 mins</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">25 mins</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">20 mins</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">15 mins</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">10 mins</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>LOADS</b></td>
<td class="org-left">heavy</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">medium</td>
</tr>
<tr>
<td class="org-left"> </td>
<td class="org-left">light</td>
</tr>
</tbody>
<tbody>
<tr>
<td class="org-left"><b>SWINGS</b></td>
<td class="org-left">0 - 100</td>
</tr>
</tbody>
</table>
<a id="org319bbb1"></a>
### last
The `last` command displays the last saved workout and calculates the stats for it.
kettlebells last
<a id="orgb4c7591"></a>
### view
Use the `view` command to search for previous workouts by date. If you have [ripgrep](https://github.com/BurntSushi/ripgrep#installation) installed, use the `--preview` flag to view more information about the workout based on the date.
kettlebells view --preview
Use the `--Program` flag to filter workouts based on a certain workout<sub>type</sub>.
kettlebells view --Program
<a id="org85a8277"></a>
### stats
The `stats` command displays the aggregated workout count, time, weight moved, number of reps, and density for all workout in the database.
kettlebells stats
1. Filtering by time
The stats command can be filtered using three arguments: `--start`, `--end`, `--year`.
Here is an example using `--start` and `--end` to get the stats from Jan 2024.
kettlebells stats --start 2024-01-01 --end 2024-02-01
If you want to see an entire year, just use `--year`.
kettlebells stats --year 2024
All three time filters work with the plots. And `--year` works with the calendar command covered later.
2. plot
To display a line plot of the weight moved per workout, use the `--plot line` option. Add a line at the median with `--median` or at the mean with `--average`.
kettlebells stats --plot line
To display a horizontal bar plot grouped by month, use the `--plot bar` option.
kettlebells stats --plot bar
To display an event plot of the current year, use the `--plot event` option.
kettlebells stats --plot event
3. calendar
To display a calendar of workouts in a given year, use the `--calendar` flag and pass the year as the argument.
kettlebells stats --calendar -y 2023
4. best
The `best` command displays the top ten workout based on the weight moved.
kettlebells stats --best
Use the `--sort` option to sort the table by:
- weight-moved (default)
- reps
- weight-density
- rep-density
- time
Raw data
{
"_id": null,
"home_page": null,
"name": "kettlebells",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "CLI, fitness, kettlebells",
"author": null,
"author_email": "Russell Helmstedter <rhelmstedter@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/96/ff/36e97f4b81022c3566c29c11d3fca5561dcf3cbfe66e7b0af4b3166257cb/kettlebells-0.2.42.tar.gz",
"platform": null,
"description": "\n# Table of Contents\n\n1. [Installation](#orgc30a08d)\n 1. [uv](#org644f9b3)\n 2. [pipx](#org3e526d7)\n2. [Usage](#org61925e3)\n 1. [Initialize](#org9dc1f6a)\n 2. [Update Exercises](#orgf9f1c9d)\n 3. [Commands](#org6ca217f)\n 1. [save](#orgaa12efc)\n 2. [random](#orgfe3c69f)\n 3. [last](#org319bbb1)\n 4. [view](#orgb4c7591)\n 5. [stats](#org85a8277)\n\nkettlebells is a CLI designed to create, save, and track the progress of kettlebell workouts. The inspiration for this project came from [Pat Flynn’s conversation with Bret Jones](https://www.chroniclesofstrength.com/what-strength-aerobics-are-and-how-to-use-them-w-brett-jones/). (For a more detailed look at Iron Cardio, go checkout the [Iron Cardio Book](https://strongandfit.com/products/iron-cardio-by-brett-jones) by Bret Jones.) After starting an [initial project](https://github.com/rhelmstedter/iron-cardio) that focused only on iron cardio, I wanted to be able to add more. This is essentially a fork of the iron-cardio project designed to add various workouts such as the armor building complex, and dry fighting weight.\n\nAs of version 0.2.1, the way workouts are constructed has completely changed. This will allow users to construct their own custom workouts in the future. It will also allow the stats to keep track of how many reps of each type of exercise have been done.\n\n\n<a id=\"orgc30a08d\"></a>\n\n# Installation\n\n\n<a id=\"org644f9b3\"></a>\n\n## [uv](https://github.com/astral-sh/uv)\n\n uv tool install kettlebells\n\n\n<a id=\"org3e526d7\"></a>\n\n## [pipx](https://github.com/pypa/pipx)\n\n pipx install kettlebells\n\n\n<a id=\"org61925e3\"></a>\n\n# Usage\n\n\n<a id=\"org9dc1f6a\"></a>\n\n## Initialize\n\nRun the `init` command to create the database.\n\n kettlebells init\n\nNext, run the `setloads` command. This sets the units to either pounds (lbs) or kilograms (kg), the user’s bodyweight, and the loads for the light, medium, and heavy kettlebell. This command can be run as needed when the user is ready to move up in load or bodyweight changes.\n\n kettlebells setloads\n\n\n<a id=\"orgf9f1c9d\"></a>\n\n## Update Exercises\n\nOccasionally, new exercises are added to the database. If you have already initialized in a previous version, run the `update` command.\n\n kettlebells update\n\n\n<a id=\"org6ca217f\"></a>\n\n## Commands\n\n\n<a id=\"orgaa12efc\"></a>\n\n### save\n\nThe `save` command saves workouts to the database. The current options are:\n\n- [ic](#org119a057)\n- [abc](#orgeaf2c20)\n- [btb](#org251f683)\n- [dfw](#orgfdfc716)\n- [pw](#orga37f1b5)\n- [rop](#orgbb8663a)\n- [wolf](#org264a3d2)\n- [custom](#org5463923)\n\nWhen run with no option, the `save` command will attempt to use the most recently generated random workout. Otherwise, use the `--workout-type` option to manually enter a workout, e.g.:\n\n kettlebells save --workout-type abc\n\n1. dfw\n\n When the `save` command is run with the workout type of `dfw`, a dry fighting weight workout is saved. See [the original post](https://www.strongfirst.com/dry-fighting-weight/) for more details\n \n kettlebells save --workout-type dfw\n\n2. btb\n\n The save command with a workout type of `btb` allows the user to save a Back to Basics Workout. These workouts are constructed based on The Pat Flynn Show episode with Dan John [The BEST Kettlebell Program for GEGINNERS | THE BTBKP](https://patflynnshow.libsyn.com/the-best-kettlebell-program-for-beginners-the-btbkp). The choices are ladders of 2-3-5 clean and presses followed by either snatches or double front squats. The warm up and cool exercises are not included in the workout.\n \n kettlebells save --workout-type btb\n \n The program options are:\n \n <table border=\"2\" cellspacing=\"0\" cellpadding=\"6\" rules=\"groups\" frame=\"hsides\">\n \n \n <colgroup>\n <col class=\"org-left\" />\n \n <col class=\"org-left\" />\n </colgroup>\n <thead>\n <tr>\n <th scope=\"col\" class=\"org-left\">First block</th>\n <th scope=\"col\" class=\"org-left\">Second Block</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"org-left\">2 ladders</td>\n <td class=\"org-left\">60 Snatches</td>\n </tr>\n \n <tr>\n <td class=\"org-left\">3 ladders</td>\n <td class=\"org-left\">80 Snatches</td>\n </tr>\n \n <tr>\n <td class=\"org-left\">5 ladders</td>\n <td class=\"org-left\">100 Snatches</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\">2 ladders</td>\n <td class=\"org-left\">10 sets of 5 Double Front Squats</td>\n </tr>\n \n <tr>\n <td class=\"org-left\">3 ladders</td>\n <td class=\"org-left\">10 sets of 5 Double Front Squats</td>\n </tr>\n \n <tr>\n <td class=\"org-left\">5 ladders</td>\n <td class=\"org-left\">10 sets of 5 Double Front Squats</td>\n </tr>\n </tbody>\n </table>\n\n3. pw\n\n The save command with a workout type of `pw` saves versions of [Dan John’s Perfect Workout](https://youtu.be/aHQLx_HhFqo?si=b68xBn41-tcGDVJE). While in the video Dan does hip thrusts until it burns, for ease of recording the workout, `kettlebells` offers a set number of reps for the hip thrust.\n \n kettlebells save --workout-type pw\n \n The program options are:\n \n <table border=\"2\" cellspacing=\"0\" cellpadding=\"6\" rules=\"groups\" frame=\"hsides\">\n \n \n <colgroup>\n <col class=\"org-left\" />\n \n <col class=\"org-left\" />\n \n <col class=\"org-right\" />\n \n <col class=\"org-right\" />\n </colgroup>\n <thead>\n <tr>\n <th scope=\"col\" class=\"org-left\">Variation</th>\n <th scope=\"col\" class=\"org-left\">Exercises</th>\n <th scope=\"col\" class=\"org-right\">Sets</th>\n <th scope=\"col\" class=\"org-right\">Reps</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>Original</b></td>\n <td class=\"org-left\">Half-kneeling Press</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Hanging Leg Raise</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Banded Hip Thrust</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">15</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Bulgarian Goat Bag Swing</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Goblet Squat / Broomstick Overhead Squat</td>\n <td class=\"org-right\">1</td>\n <td class=\"org-right\">8</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>Indoor</b></td>\n <td class=\"org-left\">Half-kneeling Press</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Child’s Pose</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">20 secs</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Hip Thrust / Clam Shell (15, 14, 13…)</td>\n <td class=\"org-right\">1</td>\n <td class=\"org-right\">120</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Goblet Squat / Broomstick Overhead Squat</td>\n <td class=\"org-right\">1</td>\n <td class=\"org-right\">8</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>The Bull</b></td>\n <td class=\"org-left\">Half-kneeling Press</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Hanging Leg Raise</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Bulgarian Goat Bag Swing</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Bent Over Rows</td>\n <td class=\"org-right\">3</td>\n <td class=\"org-right\">8</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Goblet Squat / Broomstick Overhead Squat</td>\n <td class=\"org-right\">1</td>\n <td class=\"org-right\">8</td>\n </tr>\n </tbody>\n </table>\n\n4. rop\n\n The save command with a workout type of `rop` saves versions of Pavel Tsatsouline’s rite of passage program from [Enter The Kettlebell](https://www.amazon.com/Enter-Kettlebell-Strength-Secret-Supermen/dp/1942812132). The clean and press and pullups are calculated as ladders, while the swings and snatches are straight sets.\n \n kettlebells save --workout-type rop\n\n5. wolf\n\n The save command with a workout type of `wolf` saves workouts from the free program [The Wolf](https://chasingstrength.com/reports/double-kettlebell-complex/) from [Geoff Neupert](https://chasingstrength.com). This is a gasser for sure.\n \n kettlebells save --workout-type wolf\n\n6. custom\n\n When the `save` command is run with the workout type of `custom`, the user can save a custom workout. Custom workouts need a `workout_type` and a `variation`. The default is `custom`. Exercises are chosen via [iterfzf](https://github.com/dahlia/iterfzf). Select `Other` to add a custom exercise. Select `Done` or press escape when finished adding all the exercises.\n \n kettlebells save --workout-type custom\n \n 1. Reps and Loads for Custom Exercises\n \n Unilateral exercises such as the single arm overhead press (simply “Press” in the program) should have the reps doubled. For example, if the set and rep scheme is 3 sets of 8 single arm overhead presses on the left and right arm, that should be saved as 16 reps per set for that exercise.\n \n When the stats are calculated, any exercise that has “Double” in it has the load multiplied by 2. So Double Pressing a pair of 24 kg kettlebells should be saved as a load of 24 kg, but the calculations will result in 48 kg per rep. If using uneven sized bells, use the average weight of the two bells rounded to the nearest integer.\n \n 2. Suggested Use for Complexes\n \n Consider a workout out like the [8 - 5 - 3 Rep Scheme](https://www.youtube.com/watch?v=nHPfglRCp6M&t=13s) from Pat Flynn. The `workout_type` would be “complex”, the `variation` would be “8-5-3 Rep Scheme”. Technically, a set consists of 8 Goblet Squats, 5 Start Stop Swings, 3 Push-ups. Then you would repeat this for 5 rounds. However, in `kettlebells` the user will add each exercise separately. So the Goblet Squat would be 5 sets of 8. The Start Stop Swing would be 5 sets of 5, and the Push-up would be 5 sets of 3.\n\n\n<a id=\"orgfe3c69f\"></a>\n\n### random\n\nThe work out command generates a random workout. The current options are:\n\n- `ic` (Iron Cardio)\n- `abc` (Armor Building Complex)\n\n1. iron-cardio\n\n The `random` command with a workout type of `ic`, generates a random iron cardio workout.\n \n kettlebells random --workout-type ic\n \n Iron cardio workouts are built from the following parameters:\n \n <table border=\"2\" cellspacing=\"0\" cellpadding=\"6\" rules=\"groups\" frame=\"hsides\">\n \n \n <colgroup>\n <col class=\"org-left\" />\n \n <col class=\"org-left\" />\n </colgroup>\n <thead>\n <tr>\n <th scope=\"col\" class=\"org-left\">Parameter</th>\n <th scope=\"col\" class=\"org-left\">Options</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>Single Bell Variations</b></td>\n <td class=\"org-left\">Classic</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Classic + Pull-up</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Classic + Snatch</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Traveling 2s</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>Double Bell Variations</b></td>\n <td class=\"org-left\">Double Classic</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Double Classic + Pull-up</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">Double Traveling 2s</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>TIMES</b></td>\n <td class=\"org-left\">30 mins</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">20 mins</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">10 mins</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>LOADS</b></td>\n <td class=\"org-left\">heavy</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">medium</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">light</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>SWINGS</b></td>\n <td class=\"org-left\">0 - 150</td>\n </tr>\n </tbody>\n </table>\n\n2. abc\n\n The random command with a workout type of `abc` will generate a random armor building complex workout.\n \n kettlebells random --workout-type abc\n \n <table border=\"2\" cellspacing=\"0\" cellpadding=\"6\" rules=\"groups\" frame=\"hsides\">\n \n \n <colgroup>\n <col class=\"org-left\" />\n \n <col class=\"org-left\" />\n </colgroup>\n <thead>\n <tr>\n <th scope=\"col\" class=\"org-left\">Parameter</th>\n <th scope=\"col\" class=\"org-left\">Options</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>Single Bell Variations</b></td>\n <td class=\"org-left\">Armor Building Complex 2.0</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>Double Bell Variations</b></td>\n <td class=\"org-left\">Armor Building Complex</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>TIMES</b></td>\n <td class=\"org-left\">30 mins</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">25 mins</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">20 mins</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">15 mins</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">10 mins</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>LOADS</b></td>\n <td class=\"org-left\">heavy</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">medium</td>\n </tr>\n \n <tr>\n <td class=\"org-left\"> </td>\n <td class=\"org-left\">light</td>\n </tr>\n </tbody>\n <tbody>\n <tr>\n <td class=\"org-left\"><b>SWINGS</b></td>\n <td class=\"org-left\">0 - 100</td>\n </tr>\n </tbody>\n </table>\n\n\n<a id=\"org319bbb1\"></a>\n\n### last\n\nThe `last` command displays the last saved workout and calculates the stats for it.\n\n kettlebells last\n\n\n<a id=\"orgb4c7591\"></a>\n\n### view\n\nUse the `view` command to search for previous workouts by date. If you have [ripgrep](https://github.com/BurntSushi/ripgrep#installation) installed, use the `--preview` flag to view more information about the workout based on the date.\n\n kettlebells view --preview\n\nUse the `--Program` flag to filter workouts based on a certain workout<sub>type</sub>.\n\n kettlebells view --Program\n\n\n<a id=\"org85a8277\"></a>\n\n### stats\n\nThe `stats` command displays the aggregated workout count, time, weight moved, number of reps, and density for all workout in the database.\n\n kettlebells stats\n\n1. Filtering by time\n\n The stats command can be filtered using three arguments: `--start`, `--end`, `--year`.\n \n Here is an example using `--start` and `--end` to get the stats from Jan 2024.\n \n kettlebells stats --start 2024-01-01 --end 2024-02-01\n \n If you want to see an entire year, just use `--year`.\n \n kettlebells stats --year 2024\n \n All three time filters work with the plots. And `--year` works with the calendar command covered later.\n\n2. plot\n\n To display a line plot of the weight moved per workout, use the `--plot line` option. Add a line at the median with `--median` or at the mean with `--average`.\n \n kettlebells stats --plot line\n \n To display a horizontal bar plot grouped by month, use the `--plot bar` option.\n \n kettlebells stats --plot bar\n \n To display an event plot of the current year, use the `--plot event` option.\n \n kettlebells stats --plot event\n\n3. calendar\n\n To display a calendar of workouts in a given year, use the `--calendar` flag and pass the year as the argument.\n \n kettlebells stats --calendar -y 2023\n\n4. best\n\n The `best` command displays the top ten workout based on the weight moved.\n \n kettlebells stats --best\n \n Use the `--sort` option to sort the table by:\n \n - weight-moved (default)\n - reps\n - weight-density\n - rep-density\n - time\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A CLI tool to create, save, and track progress of kettlebell workouts.",
"version": "0.2.42",
"project_urls": null,
"split_keywords": [
"cli",
" fitness",
" kettlebells"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "65703d020ce689be7941e58b1cd8f4b9af7f80c73e2e667ab1c371c1ee0d6240",
"md5": "84bea502faffafb84a7c034c01830f7f",
"sha256": "c7f54e1ec9f15635a4d4f011a5744f2de9cdcdf86ce5467e481fdaba1689b970"
},
"downloads": -1,
"filename": "kettlebells-0.2.42-py3-none-any.whl",
"has_sig": false,
"md5_digest": "84bea502faffafb84a7c034c01830f7f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 35053,
"upload_time": "2025-02-08T18:05:35",
"upload_time_iso_8601": "2025-02-08T18:05:35.996381Z",
"url": "https://files.pythonhosted.org/packages/65/70/3d020ce689be7941e58b1cd8f4b9af7f80c73e2e667ab1c371c1ee0d6240/kettlebells-0.2.42-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "96ff36e97f4b81022c3566c29c11d3fca5561dcf3cbfe66e7b0af4b3166257cb",
"md5": "773fa5003bdb6720ccdc773a954dfaef",
"sha256": "2df4521b5715deb336bf59298d69071e5b5f0cb7bf465082ff0242d6ce1e23fc"
},
"downloads": -1,
"filename": "kettlebells-0.2.42.tar.gz",
"has_sig": false,
"md5_digest": "773fa5003bdb6720ccdc773a954dfaef",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 67205,
"upload_time": "2025-02-08T18:05:37",
"upload_time_iso_8601": "2025-02-08T18:05:37.693029Z",
"url": "https://files.pythonhosted.org/packages/96/ff/36e97f4b81022c3566c29c11d3fca5561dcf3cbfe66e7b0af4b3166257cb/kettlebells-0.2.42.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-08 18:05:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "kettlebells"
}
