PyPI - rolling-pin - Versions diffs - 0.9.5__py3-none-any.whl → 0.10.0__py3-none-any.whl - Mend

rolling-pin 0.9.5py3-none-any.whl → 0.10.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

rolling_pin/radon_etl.py +52 -39
rolling_pin/repo_etl.py +2 -0
rolling_pin/tools.py +77 -12
rolling_pin-0.10.0.dist-info/METADATA +443 -0
rolling_pin-0.10.0.dist-info/RECORD +15 -0
{rolling_pin-0.9.5.dist-info → rolling_pin-0.10.0.dist-info}/licenses/LICENSE +1 -1
rolling_pin-0.9.5.dist-info/METADATA +0 -354
rolling_pin-0.9.5.dist-info/RECORD +0 -15
{rolling_pin-0.9.5.dist-info → rolling_pin-0.10.0.dist-info}/WHEEL +0 -0
{rolling_pin-0.9.5.dist-info → rolling_pin-0.10.0.dist-info}/entry_points.txt +0 -0

rolling_pin/radon_etl.py CHANGED Viewed

@@ -5,13 +5,13 @@ import os
 import re
 from pathlib import Path
-import cufflinks as cf
+from pandas import DataFrame
+from radon.cli import CCHarvester, HCHarvester, MIHarvester, RawHarvester
+from radon.cli import Config
 import numpy as np
 import pandas as pd
-from pandas import DataFrame
+import plotly.express as px
 import radon.complexity
-from radon.cli import Config
-from radon.cli import CCHarvester, HCHarvester, MIHarvester, RawHarvester
 from rolling_pin.blob_etl import BlobETL
 import rolling_pin.tools as rpt
@@ -413,8 +413,6 @@ class RadonETL():
         Returns:
             RadonETL: self.
         '''
-        cf.go_offline()
         def remove_test_modules(data):
             # type: (DataFrame) -> DataFrame
             mask = data.fullpath\
@@ -436,13 +434,6 @@ class RadonETL():
             bugs='bugs (B) - V / 3000 - an estimate of the errors in the implementation',
         )
-        params = dict(
-            theme='henanigans',
-            colors=rpt.COLOR_SCALE,
-            dimensions=(900, 900),
-            asFigure=True,
-        )
         html = '<body style="background: #242424">\n'
         raw = remove_test_modules(self.raw_metrics)
@@ -452,42 +443,64 @@ class RadonETL():
         raw['docstring_ratio'] = raw.multiline_comment / raw.code
         raw.sort_values('docstring_ratio', inplace=True)
-        html += raw.iplot(
-            x='fullpath',
-            kind='barh',
+        # line count
+        fig = px.bar(
+            raw,
             title='Line Count Metrics',
-            **params
-        ).to_html()
+            x=raw.drop(columns='fullpath').columns.tolist(),
+            y='fullpath',
+            orientation='h',
+            barmode='group',
+            width=900,
+            height=900,
+            color_discrete_sequence=rpt.COLOR_SCALE,
+        )
+        fig.layout.update(rpt.PLOTLY_LAYOUT_THEME)
+        html += fig.to_html()
-        html += mi.iplot(
-            x='fullpath',
-            kind='barh',
+        # maintainability
+        fig = px.bar(
+            mi,
             title='Maintainability Metrics',
-            **params
-        ).to_html()
-        params['dimensions'] = (900, 500)
+            x='maintainability_index',
+            y='fullpath',
+            orientation='h',
+            barmode='group',
+            width=900,
+            height=900,
+            color_discrete_sequence=rpt.COLOR_SCALE,
+        )
+        fig.layout.update(rpt.PLOTLY_LAYOUT_THEME)
+        html += fig.to_html()
-        cols = ['cyclomatic_complexity', 'cyclomatic_rank']
-        html += cc[cols].iplot(
-            kind='hist',
-            bins=50,
+        # cyclomatic
+        fig = px.histogram(
+            cc[['cyclomatic_complexity', 'cyclomatic_rank']],
             title='Cyclomatic Metric Distributions',
-            **params
-        ).to_html()
+            nbins=10,
+            width=900,
+            height=500,
+            color_discrete_sequence=rpt.COLOR_SCALE,
+        )
+        fig.layout.update(rpt.PLOTLY_LAYOUT_THEME)
+        html += fig.to_html()
+        # halstead
         cols = [
             'h1', 'h2', 'n1', 'n2', 'vocabulary', 'length', 'calculated_length',
             'volume', 'difficulty', 'effort', 'time', 'bugs'
         ]
-        html += hal[cols]\
-            .rename(mapper=lambda x: lut[x], axis=1)\
-            .iplot(
-                kind='hist',
-                bins=50,
-                title='Halstead Metric Distributions',
-                **params)\
-            .to_html()
+        fig = px.histogram(
+            hal[cols].rename(mapper=lambda x: lut[x], axis=1),
+            title='Halstead Metric Distributions',
+            nbins=10,
+            width=1400,
+            height=500,
+            color_discrete_sequence=rpt.COLOR_SCALE,
+        )
+        fig.layout.update(rpt.PLOTLY_LAYOUT_THEME)
+        html += fig.to_html()
         html += '\n</body>'

rolling_pin/repo_etl.py CHANGED Viewed

@@ -275,6 +275,8 @@ class RepoETL():
         '''
         x = anneal_axis
         y = pin_axis
+        data[x] = data[x].astype(float)
+        data[y] = data[y].astype(float)
         for iteration in range(iterations):
             # create directed graph from data
             graph = RepoETL._to_networkx_graph(data)

rolling_pin/tools.py CHANGED Viewed

@@ -38,18 +38,83 @@ COLOR_SCHEME = dict(
     edge_module='#B6ECF3',
 )  # type: Dict[str, str]
+PLOTLY_COLOR_SCHEME = dict(
+    bg='#242424',
+    blue1='#5F95DE',
+    blue2='#93B6E6',
+    cyan1='#7EC4CF',
+    cyan2='#B6ECF3',
+    dark1='#040404',
+    dark2='#141414',
+    dialog1='#444459',
+    dialog2='#5D5D7A',
+    green1='#8BD155',
+    green2='#A0D17B',
+    grey1='#343434',
+    grey2='#444444',
+    light1='#A4A4A4',
+    light2='#F4F4F4',
+    orange1='#EB9E58',
+    orange2='#EBB483',
+    purple1='#C98FDE',
+    purple2='#AC92DE',
+    red1='#F77E70',
+    red2='#DE958E',
+    yellow1='#E8EA7E',
+    yellow2='#E9EABE',
+)
 COLOR_SCALE = [
-    '#B6ECF3',
-    '#DE958E',
-    '#EBB483',
-    '#A0D17B',
-    '#93B6E6',
-    '#AC92DE',
-    '#E9EABE',
-    '#7EC4CF',
-    '#F77E70',
-    '#EB9E58',
+    'cyan2', 'red2', 'green2', 'blue2', 'orange2', 'purple2', 'yellow2',
+    'light2', 'cyan1', 'red1', 'green1', 'blue1'
 ]  # type: List[str]
+COLOR_SCALE = [PLOTLY_COLOR_SCHEME[x] for x in COLOR_SCALE]
+PLOTLY_LAYOUT_THEME = {
+    'legend': {
+        'bgcolor': PLOTLY_COLOR_SCHEME['bg'],
+        'title': {'text': ''},
+        'font': {
+            'color': PLOTLY_COLOR_SCHEME['light2']
+        }
+    },
+    'paper_bgcolor': PLOTLY_COLOR_SCHEME['bg'],
+    'plot_bgcolor': PLOTLY_COLOR_SCHEME['bg'],
+    'title': {
+        'font': {
+            'color': PLOTLY_COLOR_SCHEME['light2']
+        }
+    },
+    'xaxis': {
+        'gridcolor': PLOTLY_COLOR_SCHEME['grey1'],
+        'showgrid': True,
+        'tickfont': {
+            'color': PLOTLY_COLOR_SCHEME['light1']
+        },
+        'title': {
+            'font': {
+                'color': PLOTLY_COLOR_SCHEME['light1']
+            }
+        },
+        'zerolinecolor': PLOTLY_COLOR_SCHEME['grey2']
+    },
+    'yaxis': {
+        'gridcolor': PLOTLY_COLOR_SCHEME['grey1'],
+        'showgrid': True,
+        'tickfont': {
+            'color': PLOTLY_COLOR_SCHEME['light1']
+        },
+        'title': {
+            'font': {
+                'color': PLOTLY_COLOR_SCHEME['light1']
+            }
+        },
+        'zerolinecolor': PLOTLY_COLOR_SCHEME['grey2']
+    }
+}
 # PREDICATE-FUNCTIONS-----------------------------------------------------------
@@ -340,9 +405,9 @@ def filter_text(
     '''
     lines = text.split('\n')
     if include_regex is not None:
-        lines = list(filter(lambda x: re.search(include_regex, x), lines))  # type: ignore
+        lines = list(filter(lambda x: re.search(include_regex, x), lines))
     if exclude_regex is not None:
-        lines = list(filter(lambda x: not re.search(exclude_regex, x), lines))  # type: ignore
+        lines = list(filter(lambda x: not re.search(exclude_regex, x), lines))
     if replace_regex is not None:
         rep_val = replace_value or ''
         lines = [re.sub(replace_regex, rep_val, x) for x in lines]

rolling_pin-0.10.0.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,443 @@
+Metadata-Version: 2.1
+Name: rolling-pin
+Version: 0.10.0
+Summary: A library of generic tools for ETL work and visualization of JSON blobs and python repositories
+License: MIT
+Keywords: ETL,blob,dependency,graph,svg,networkx,transform,code metrics,dependency diagram,build system
+Author-email: Alex Braun <alexander.g.braun@gmail.com>
+Requires-Python: >=3.8
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Typing :: Typed
+Requires-Dist: click>=8.1.3
+Requires-Dist: graphviz
+Requires-Dist: ipython
+Requires-Dist: lunchbox
+Requires-Dist: networkx
+Requires-Dist: numpy<=1.24.4,>=1.23.4
+Requires-Dist: pandas>=1.1.5
+Requires-Dist: plotly>=5.22.0
+Requires-Dist: pydot<=1.4.2
+Requires-Dist: pyyaml
+Requires-Dist: radon<6.0.0
+Requires-Dist: schematics
+Requires-Dist: toml>=0.10.2
+Requires-Dist: wrapt
+Project-URL: documentation, https://thenewflesh.github.io/rolling-pin
+Project-URL: repository, https://github.com/theNewFlesh/rolling-pin
+Description-Content-Type: text/markdown
+<p>
+    <a href="https://www.linkedin.com/in/alexandergbraun" rel="nofollow noreferrer">
+        <img src="https://www.gomezaparicio.com/wp-content/uploads/2012/03/linkedin-logo-1-150x150.png"
+             alt="linkedin" width="30px" height="30px"
+        >
+    </a>
+    <a href="https://github.com/theNewFlesh" rel="nofollow noreferrer">
+        <img src="https://tadeuzagallo.com/GithubPulse/assets/img/app-icon-github.png"
+             alt="github" width="30px" height="30px"
+        >
+    </a>
+    <a href="https://pypi.org/user/the-new-flesh" rel="nofollow noreferrer">
+        <img src="https://cdn.iconscout.com/icon/free/png-256/python-2-226051.png"
+             alt="pypi" width="30px" height="30px"
+        >
+    </a>
+    <a href="http://vimeo.com/user3965452" rel="nofollow noreferrer">
+        <img src="https://cdn.iconscout.com/icon/free/png-512/movie-52-151107.png?f=avif&w=512"
+             alt="vimeo" width="30px" height="30px"
+        >
+    </a>
+    <a href="http://www.alexgbraun.com" rel="nofollow noreferrer">
+        <img src="https://i.ibb.co/fvyMkpM/logo.png"
+             alt="alexgbraun" width="30px" height="30px"
+        >
+    </a>
+</p>
+<!-- <img id="logo" src="resources/logo.png" style="max-width: 717px"> -->
+[![](https://img.shields.io/badge/License-MIT-F77E70.svg?style=for-the-badge)](https://github.com/theNewFlesh/rolling-pin/blob/master/LICENSE)
+[![](https://img.shields.io/pypi/pyversions/rolling-pin?style=for-the-badge&label=Python&color=A0D17B&logo=python&logoColor=A0D17B)](https://github.com/theNewFlesh/rolling-pin/blob/master/docker/config/pyproject.toml)
+[![](https://img.shields.io/pypi/v/rolling-pin?style=for-the-badge&label=PyPI&color=5F95DE&logo=pypi&logoColor=5F95DE)](https://pypi.org/project/rolling-pin/)
+[![](https://img.shields.io/pypi/dm/rolling-pin?style=for-the-badge&label=Downloads&color=5F95DE)](https://pepy.tech/project/rolling-pin)
+# Introduction
+Rolling-pin is a library of generic tools for ETL work and visualization of JSON
+blobs and python repositories
+See [documentation](https://thenewflesh.github.io/rolling-pin/) for details.
+On the documentation main page, under the *Architecture* section, is a
+dynamically generated dependency graph of rolling-pin's current architecture.
+It is generated using the RepoETL class.
+If you look under the *Metrics* section you will find Radon code metric plots
+and data of the rolling-pin source code, generated by the RadonETL class.
+Also have a look at this
+**[Jupyter notebook demo](https://github.com/theNewFlesh/rolling-pin/blob/master/notebooks/prototype_demo.ipynb)**
+for a taste of what rolling-pin can do.
+---
+# Installation for Developers
+### Docker
+1. Install [docker-desktop](https://docs.docker.com/desktop/)
+2. Ensure docker-desktop has at least 4 GB of memory allocated to it.
+3. `git clone git@github.com:theNewFlesh/rolling-pin.git`
+4. `cd rolling-pin`
+5. `chmod +x bin/rolling-pin`
+6. `bin/rolling-pin docker-start`
+   - If building on a M1 Mac run `export DOCKER_DEFAULT_PLATFORM=linux/amd64` first.
+The service should take a few minutes to start up.
+Run `bin/rolling-pin --help` for more help on the command line tool.
+### ZSH Setup
+1. `bin/rolling-pin` must be run from this repository's top level directory.
+2. Therefore, if using zsh, it is recommended that you paste the following line
+    in your ~/.zshrc file:
+    - `alias rolling-pin="cd [parent dir]/rolling-pin; bin/rolling-pin"`
+    - Replace `[parent dir]` with the parent directory of this repository
+3. Consider adding the following line to your ~/.zshrc if you are using a M1 Mac:
+    - `export DOCKER_DEFAULT_PLATFORM=linux/amd64`
+4. Running the `zsh-complete` command will enable tab completions of the cli
+   commands, in the next shell session.
+   For example:
+   - `rolling-pin [tab]` will show you all the cli options, which you can press
+     tab to cycle through
+   - `rolling-pin docker-[tab]` will show you only the cli options that begin with
+     "docker-"
+# Installation for Production
+### Python
+`pip install rolling-pin`
+### Docker
+1. Install [docker-desktop](https://docs.docker.com/desktop/)
+2. `docker pull theNewFlesh/rolling-pin:[version]`
+---
+# Quickstart Guide
+This repository contains a suite commands for the whole development process.
+This includes everything from testing, to documentation generation and
+publishing pip packages.
+These commands can be accessed through:
+  - The VSCode task runner
+  - The VSCode task runner side bar
+  - A terminal running on the host OS
+  - A terminal within this repositories docker container
+Running the `zsh-complete` command will enable tab completions of the CLI.
+See the zsh setup section for more information.
+### Command Groups
+Development commands are grouped by one of 10 prefixes:
+| Command    | Description                                                                        |
+| ---------- | ---------------------------------------------------------------------------------- |
+| build      | Commands for building packages for testing and pip publishing                      |
+| docker     | Common docker commands such as build, start and stop                               |
+| docs       | Commands for generating documentation and code metrics                             |
+| library    | Commands for managing python package dependencies                                  |
+| session    | Commands for starting interactive sessions such as jupyter lab and python          |
+| state      | Command to display the current state of the repo and container                     |
+| test       | Commands for running tests, linter and type annotations                            |
+| version    | Commands for bumping project versions                                              |
+| quickstart | Display this quickstart guide                                                      |
+| zsh        | Commands for running a zsh session in the container and generating zsh completions |
+### Common Commands
+Here are some frequently used commands to get you started:
+| Command           | Description                                               |
+| ----------------- | --------------------------------------------------------- |
+| docker-restart    | Restart container                                         |
+| docker-start      | Start container                                           |
+| docker-stop       | Stop container                                            |
+| docs-full         | Generate documentation, coverage report, diagram and code |
+| library-add       | Add a given package to a given dependency group           |
+| library-graph-dev | Graph dependencies in dev environment                     |
+| library-remove    | Remove a given package from a given dependency group      |
+| library-search    | Search for pip packages                                   |
+| library-update    | Update dev dependencies                                   |
+| session-lab       | Run jupyter lab server                                    |
+| state             | State of                                                  |
+| test-dev          | Run all tests                                             |
+| test-lint         | Run linting and type checking                             |
+| zsh               | Run ZSH session inside container                          |
+| zsh-complete      | Generate ZSH completion script                            |
+---
+# Development CLI
+bin/rolling-pin is a command line interface (defined in cli.py) that
+works with any version of python 2.7 and above, as it has no dependencies.
+Commands generally do not expect any arguments or flags.
+Its usage pattern is: `bin/rolling-pin COMMAND [-a --args]=ARGS [-h --help] [--dryrun]`
+### Commands
+The following is a complete list of all available development commands:
+| Command                 | Description                                                         |
+| ----------------------- | ------------------------------------------------------------------- |
+| build-package           | Build production version of repo for publishing                     |
+| build-prod              | Publish pip package of repo to PyPi                                 |
+| build-publish           | Run production tests first then publish pip package of repo to PyPi |
+| build-test              | Build test version of repo for prod testing                         |
+| docker-build            | Build Docker image                                                  |
+| docker-build-from-cache | Build Docker image from cached image                                |
+| docker-build-prod       | Build production image                                              |
+| docker-container        | Display the Docker container id                                     |
+| docker-destroy          | Shutdown container and destroy its image                            |
+| docker-destroy-prod     | Shutdown production container and destroy its image                 |
+| docker-image            | Display the Docker image id                                         |
+| docker-prod             | Start production container                                          |
+| docker-pull-dev         | Pull development image from Docker registry                         |
+| docker-pull-prod        | Pull production image from Docker registry                          |
+| docker-push-dev         | Push development image to Docker registry                           |
+| docker-push-dev-latest  | Push development image to Docker registry with dev-latest tag       |
+| docker-push-prod        | Push production image to Docker registry                            |
+| docker-push-prod-latest | Push production image to Docker registry with prod-latest tag       |
+| docker-remove           | Remove Docker image                                                 |
+| docker-restart          | Restart Docker container                                            |
+| docker-start            | Start Docker container                                              |
+| docker-stop             | Stop Docker container                                               |
+| docs                    | Generate sphinx documentation                                       |
+| docs-architecture       | Generate architecture.svg diagram from all import statements        |
+| docs-full               | Generate documentation, coverage report, diagram and code           |
+| docs-metrics            | Generate code metrics report, plots and tables                      |
+| library-add             | Add a given package to a given dependency group                     |
+| library-graph-dev       | Graph dependencies in dev environment                               |
+| library-graph-prod      | Graph dependencies in prod environment                              |
+| library-install-dev     | Install all dependencies into dev environment                       |
+| library-install-prod    | Install all dependencies into prod environment                      |
+| library-list-dev        | List packages in dev environment                                    |
+| library-list-prod       | List packages in prod environment                                   |
+| library-lock-dev        | Resolve dev.lock file                                               |
+| library-lock-prod       | Resolve prod.lock file                                              |
+| library-remove          | Remove a given package from a given dependency group                |
+| library-search          | Search for pip packages                                             |
+| library-sync-dev        | Sync dev environment with packages listed in dev.lock               |
+| library-sync-prod       | Sync prod environment with packages listed in prod.lock             |
+| library-update          | Update dev dependencies                                             |
+| library-update-pdm      | Update PDM                                                          |
+| quickstart              | Display quickstart guide                                            |
+| session-lab             | Run jupyter lab server                                              |
+| session-python          | Run python session with dev dependencies                            |
+| session-server          | Runn application server inside Docker container                     |
+| state                   | State of repository and Docker container                            |
+| test-coverage           | Generate test coverage report                                       |
+| test-dev                | Run all tests                                                       |
+| test-fast               | Test all code excepts tests marked with SKIP_SLOWS_TESTS decorator  |
+| test-lint               | Run linting and type checking                                       |
+| test-prod               | Run tests across all support python versions                        |
+| version                 | Full resolution of repo: dependencies, linting, tests, docs, etc    |
+| version-bump-major      | Bump pyproject major version                                        |
+| version-bump-minor      | Bump pyproject minor version                                        |
+| version-bump-patch      | Bump pyproject patch version                                        |
+| version-commit          | Tag with version and commit changes to master                       |
+| zsh                     | Run ZSH session inside Docker container                             |
+| zsh-complete            | Generate oh-my-zsh completions                                      |
+| zsh-root                | Run ZSH session as root inside Docker container                     |
+### Flags
+| Short | Long      | Description                                          |
+| ----- | --------- | ---------------------------------------------------- |
+| -a    | --args    | Additional arguments, this can generally be ignored  |
+| -h    | --help    | Prints command help message to stdout                |
+|       | --dryrun  | Prints command that would otherwise be run to stdout |
+---
+# Production CLI
+Rolling-pin comes with a command line interface defined in command.py.
+Its usage pattern is: `rolling-pin COMMAND [ARGS] [FLAGS] [-h --help]`
+## Commands
+---
+### bash-completion
+Prints BASH completion code to be written to a _rolling-pin completion file
+Usage: `rolling-pin bash-completion`
+---
+### zsh-completion
+Prints ZSH completion code to be written to a _rolling-pin completion file
+Usage: `rolling-pin zsh-completion`
+---
+### conform
+Copies source files to target filepaths according to given conform file.
+Usage: `rolling-pin conform [OPTIONS] SOURCE`
+| Argument | Description           |
+| -------- | --------------------- |
+| source   | conform YAML filepath |
+| Flag      | Argument | Description                                    | Default |
+| --------- | -------- | ---------------------------------------------- | ------- |
+| --groups  | text     | comma separated list of groups to be conformed | all     |
+| --dryrun  | <p></p>  | Print out conform table instead of run conform | <p></p> |
+| --help    | <p></p>  | print help message                             | <p></p> |
+---
+### graph
+Generate a dependency graph of a source repository and write it to a given filepath
+Usage: `rolling-pin graph [OPTIONS] SOURCE TARGET`
+| Argument | Description     |
+| -------- | --------------- |
+| source   | repository path |
+| target   | target filepath |
+| Flag      | Argument | Description                                 | Default   |
+| --------- | -------- | ------------------------------------------- | --------- |
+| --include | text     | include files that match this regex pattern | .*\.py$'  |
+| --exclude | text     | exclude files that match this regex pattern | test|mock |
+| --orient  | text     | graph orientation                           | lr        |
+| --help    | <p></p>  | print help message                          | <p></p>   |
+---
+### plot
+Write radon metrics plots of given repository to given filepath.
+Usage: `rolling-pin plot [OPTIONS] SOURCE TARGET`
+| Argument | Description     |
+| -------- | --------------- |
+| source   | repository path |
+| target   | plot filepath   |
+| Flag   | Description        |
+| ------ | ------------------ |
+| --help | print help message |
+---
+### table
+Write radon metrics tables of given repository to given directory.
+Usage: `rolling-pin table [OPTIONS] SOURCE TARGET`
+| Argument | Description     |
+| -------- | --------------- |
+| source   | repository path |
+| target   | table directory |
+| Flag   | Description        |
+| ------ | ------------------ |
+| --help | print help message |
+---
+### toml
+Generate a copy of a given TOML file with given edits indicated by flags. Flags
+are evalauted in the following order: edit, delete, search. Flags may be
+arbitrarily combined. Edit and delete flags may appear multiple times.
+Usage: `rolling-pin toml [OPTIONS] SOURCE`
+| Argument | Description   |
+| -------- | ------------- |
+| source   | TOML filepath |
+| Flag      | Argument | Description                                                                               |
+| --------- | -------- | ----------------------------------------------------------------------------------------- |
+| --edit    | text     | replace key's value with given value, text is "=" separated key value pair in TOML format |
+| --delete  | text     | delete keys that match this regular expression                                            |
+| --search  | text     | search for keys that match this regular expression                                        |
+| --target  | text     | target filepath to write to                                                               |
+| --help    | <p></p>  | print help message                                                                        |
+#### *Example Usage*
+**example file**
+```
+>>>cat example.toml
+[root]
+a = 1
+b = 2
+[root.foo.bar]
+x = "y"
+[world]
+hello = true
+```
+**edit flag**
+```
+>>>rolling-pin toml foobar.toml --edit 'root.a=999'
+[root]
+a = 999
+b = 2...
+>>>rolling-pin toml foobar.toml \
+        --edit 'root.a=[1, 2]'   \
+        --edit 'root.b="xxx"'
+[root]
+a = [
+    1,
+    2,
+]
+b = "xxx"...
+>>>rolling-pin toml foobar.toml --edit 'root.foo.bar="baz"'
+...
+hello = true
+[root.foo]
+bar = "baz"...
+```
+**delete flag**
+```
+>>>rolling-pin toml foobar.toml \
+        --delete 'root.foo.bar'  \
+        --delete 'root.a'
+[root]
+b = 2
+[world]
+hello = true
+```
+**search flag**
+```
+>>>rolling-pin toml foobar.toml --search 'root.foo|world'
+[world]
+hello = true
+[root.foo.bar]
+x = "y"
+```

rolling_pin-0.10.0.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,15 @@
+rolling_pin/__init__.py,sha256=R_g0FYses--dTmvbZLtFFI-FPn4og6p8zmkEesYmN1A,511
+rolling_pin/blob_etl.py,sha256=79eEeCZwPeJ8XwMlLp9-MywDwC-HlqMK-MJhksLrPdU,20712
+rolling_pin/command.py,sha256=xaM3Zp516sS2iF8RWb6qwGpc_IYmIkwtzJ2vDK9zPZo,6477
+rolling_pin/conform_config.py,sha256=W-Ps6FPuZ7SOxFOfEjIo2MZac1vCRuVky6samSZPQkw,2630
+rolling_pin/conform_etl.py,sha256=VyHAKVvdOtjx6Fy8dWn6XMfNh9OFgBbidyDUnSl3Zl4,9594
+rolling_pin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rolling_pin/radon_etl.py,sha256=0rxFSnv2z41vKFe35XqCHSnnjT9qNNjouaCcIYkcHgI,18252
+rolling_pin/repo_etl.py,sha256=W3ms6zdK22A6d9kVzHLP3HE1h0fTPMUeXww0c57Nq-k,20479
+rolling_pin/toml_etl.py,sha256=fyioQTfqFW1e15qZ8F64sX379V5JzNlBKBuC5IPIgIo,4350
+rolling_pin/tools.py,sha256=bLZGXDg5DuV59RxiVjLIwTAr83X5nMBElvR7w0mEnx8,19179
+rolling_pin-0.10.0.dist-info/entry_points.txt,sha256=nbMiJnGLhp49xrtx1pjK8sJiBrwkpj2kq-ezp8Zfyyk,56
+rolling_pin-0.10.0.dist-info/WHEEL,sha256=B19PGBCYhWaz2p_UjAoRVh767nYQfk14Sn4TpIZ-nfU,87
+rolling_pin-0.10.0.dist-info/METADATA,sha256=Oh1-rm5lU1LsZg4ufs40VoEQd9FR7M2MBJ5GINJfpJw,20063
+rolling_pin-0.10.0.dist-info/licenses/LICENSE,sha256=Z61vsRc9ZyRu0Tm3TkYgIeKDjUJCR3dT0hJonw9Q3i4,1067
+rolling_pin-0.10.0.dist-info/RECORD,,

{rolling_pin-0.9.5.dist-info → rolling_pin-0.10.0.dist-info}/licenses/LICENSE RENAMED Viewed

@@ -1,6 +1,6 @@
 MIT License
-Copyright (c) 2022 Alex Braun
+Copyright (c) 2024 Alex Braun
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

rolling_pin-0.9.5.dist-info/METADATA DELETED Viewed

@@ -1,354 +0,0 @@
-Metadata-Version: 2.1
-Name: rolling-pin
-Version: 0.9.5
-Summary: A library of generic tools for ETL work and visualization of JSON blobs and python repositories
-License: MIT
-Keywords: ETL,blob,dependency,graph,svg,networkx,transform,code metrics,dependency diagram,build system
-Author-email: Alex Braun <alexander.g.braun@gmail.com>
-Requires-Python: >=3.8
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Typing :: Typed
-Requires-Dist: click>=8.1.3
-Requires-Dist: cufflinks
-Requires-Dist: graphviz
-Requires-Dist: ipython
-Requires-Dist: lunchbox
-Requires-Dist: networkx
-Requires-Dist: numpy<=1.24.4,>=1.23.4
-Requires-Dist: pandas>=1.1.5
-Requires-Dist: pydot
-Requires-Dist: pyyaml
-Requires-Dist: radon<6.0.0
-Requires-Dist: schematics
-Requires-Dist: toml>=0.10.2
-Requires-Dist: wrapt
-Project-URL: documentation, https://thenewflesh.github.io/rolling-pin
-Project-URL: repository, https://github.com/theNewFlesh/rolling-pin
-Description-Content-Type: text/markdown
-<p>
-    <a href="https://www.linkedin.com/in/alexandergbraun" rel="nofollow noreferrer">
-        <img src="https://www.gomezaparicio.com/wp-content/uploads/2012/03/linkedin-logo-1-150x150.png"
-             alt="linkedin" width="30px" height="30px"
-        >
-    </a>
-    <a href="https://github.com/theNewFlesh" rel="nofollow noreferrer">
-        <img src="https://tadeuzagallo.com/GithubPulse/assets/img/app-icon-github.png"
-             alt="github" width="30px" height="30px"
-        >
-    </a>
-    <a href="https://pypi.org/user/the-new-flesh" rel="nofollow noreferrer">
-        <img src="https://cdn.iconscout.com/icon/free/png-256/python-2-226051.png"
-             alt="pypi" width="30px" height="30px"
-        >
-    </a>
-    <a href="http://vimeo.com/user3965452" rel="nofollow noreferrer">
-        <img src="https://cdn.iconscout.com/icon/free/png-512/movie-52-151107.png?f=avif&w=512"
-             alt="vimeo" width="30px" height="30px"
-        >
-    </a>
-    <a href="http://www.alexgbraun.com" rel="nofollow noreferrer">
-        <img src="https://i.ibb.co/fvyMkpM/logo.png"
-             alt="alexgbraun" width="30px" height="30px"
-        >
-    </a>
-</p>
-<!-- <img id="logo" src="resources/logo.png" style="max-width: 717px"> -->
-[![](https://img.shields.io/badge/License-MIT-F77E70.svg?style=for-the-badge)](https://github.com/theNewFlesh/rolling-pin/blob/master/LICENSE)
-[![](https://img.shields.io/pypi/pyversions/rolling-pin?style=for-the-badge&label=Python&color=A0D17B&logo=python&logoColor=A0D17B)](https://github.com/theNewFlesh/rolling-pin/blob/master/docker/config/pyproject.toml)
-[![](https://img.shields.io/pypi/v/rolling-pin?style=for-the-badge&label=PyPI&color=5F95DE&logo=pypi&logoColor=5F95DE)](https://pypi.org/project/rolling-pin/)
-[![](https://img.shields.io/pypi/dm/rolling-pin?style=for-the-badge&label=Downloads&color=5F95DE)](https://pepy.tech/project/rolling-pin)
-# Introduction
-Rolling-pin is a library of generic tools for ETL work and visualization of JSON
-blobs and python repositories
-See [documentation](https://thenewflesh.github.io/rolling-pin/) for details.
-On the documentation main page, under the *Architecture* section, is a
-dynamically generated dependency graph of rolling-pin's current architecture.
-It is generated using the RepoETL class.
-If you look under the *Metrics* section you will find Radon code metric plots
-and data of the rolling-pin source code, generated by the RadonETL class.
-Also have a look at this
-**[Jupyter notebook demo](https://github.com/theNewFlesh/rolling-pin/blob/master/notebooks/prototype_demo.ipynb)**
-for a taste of what rolling-pin can do.
----
-# Installation
-### Python
-`pip install rolling-pin`
-### Docker
-1. Install [docker-desktop](https://docs.docker.com/desktop/)
-2. `docker pull thenewflesh/rolling-pin:latest`
-### Docker For Developers
-1. Install [docker-desktop](https://docs.docker.com/desktop/)
-2. Ensure docker-desktop has at least 4 GB of memory allocated to it.
-3. `git clone git@github.com:theNewFlesh/rolling-pin.git`
-4. `cd rolling-pin`
-6. `chmod +x bin/rolling-pin`
-7. `bin/rolling-pin docker-start`
-The service should take a few minutes to start up.
-Run `bin/rolling-pin --help` for more help on the command line tool.
----
-# Production CLI
-Rolling-pin comes with a command line interface defined in command.py.
-Its usage pattern is: `rolling-pin COMMAND [ARGS] [FLAGS] [-h --help]`
-## Commands
----
-### bash-completion
-Prints BASH completion code to be written to a _rolling-pin completion file
-Usage: `rolling-pin bash-completion`
----
-### zsh-completion
-Prints ZSH completion code to be written to a _rolling-pin completion file
-Usage: `rolling-pin zsh-completion`
----
-### conform
-Copies source files to target filepaths according to given conform file.
-Usage: `rolling-pin conform [OPTIONS] SOURCE`
-| Argument | Description           |
-| -------- | --------------------- |
-| source   | conform YAML filepath |
-| Flag      | Argument | Description                                    | Default |
-| --------- | -------- | ---------------------------------------------- | ------- |
-| --groups  | text     | comma separated list of groups to be conformed | all     |
-| --dryrun  | -        | Print out conform table instead of run conform | -       |
-| --help    | -        | print help message                             | -       |
----
-### graph
-Generate a dependency graph of a source repository and write it to a given filepath
-Usage: `rolling-pin graph [OPTIONS] SOURCE TARGET`
-| Argument | Description     |
-| -------- | --------------- |
-| source   | repository path |
-| target   | target filepath |
-| Flag      | Argument | Description                                 | Default   |
-| --------- | -------- | ------------------------------------------- | --------- |
-| --include | text     | include files that match this regex pattern | .*\.py$'  |
-| --exclude | text     | exclude files that match this regex pattern | test|mock |
-| --orient  | text     | graph orientation                           | lr        |
-| --help    | -        | print help message                          | -         |
----
-### plot
-Write radon metrics plots of given repository to given filepath.
-Usage: `rolling-pin plot [OPTIONS] SOURCE TARGET`
-| Argument | Description     |
-| -------- | --------------- |
-| source   | repository path |
-| target   | plot filepath   |
-| Flag   | Description        |
-| ------ | ------------------ |
-| --help | print help message |
----
-### table
-Write radon metrics tables of given repository to given directory.
-Usage: `rolling-pin table [OPTIONS] SOURCE TARGET`
-| Argument | Description     |
-| -------- | --------------- |
-| source   | repository path |
-| target   | table directory |
-| Flag   | Description        |
-| ------ | ------------------ |
-| --help | print help message |
----
-### toml
-Generate a copy of a given TOML file with given edits indicated by flags. Flags
-are evalauted in the following order: edit, delete, search. Flags may be
-arbitrarily combined. Edit and delete flags may appear multiple times.
-Usage: `rolling-pin toml [OPTIONS] SOURCE`
-| Argument | Description   |
-| -------- | ------------- |
-| source   | TOML filepath |
-| Flag      | Argument | Description                                                                               |
-| --------- | -------- | ----------------------------------------------------------------------------------------- |
-| --edit    | text     | replace key's value with given value, text is "=" separated key value pair in TOML format |
-| --delete  | text     | delete keys that match this regular expression                                            |
-| --search  | text     | search for keys that match this regular expression                                        |
-| --target  | text     | target filepath to write to                                                               |
-| --help    | -        | print help message                                                                        |
-#### *Example Usage*
-**example file**
-```
->>>cat example.toml
-[root]
-a = 1
-b = 2
-[root.foo.bar]
-x = "y"
-[world]
-hello = true
-```
-**edit flag**
-```
->>>rolling-pin toml foobar.toml --edit 'root.a=999'
-[root]
-a = 999
-b = 2...
->>>rolling-pin toml foobar.toml \
-        --edit 'root.a=[1, 2]'   \
-        --edit 'root.b="xxx"'
-[root]
-a = [
-    1,
-    2,
-]
-b = "xxx"...
->>>rolling-pin toml foobar.toml --edit 'root.foo.bar="baz"'
-...
-hello = true
-[root.foo]
-bar = "baz"...
-```
-**delete flag**
-```
->>>rolling-pin toml foobar.toml \
-        --delete 'root.foo.bar'  \
-        --delete 'root.a'
-[root]
-b = 2
-[world]
-hello = true
-```
-**search flag**
-```
->>>rolling-pin toml foobar.toml --search 'root.foo|world'
-[world]
-hello = true
-[root.foo.bar]
-x = "y"
-```
----
-# Development CLI
-bin/rolling-pin is a command line interface (defined in cli.py) that works with
-any version of python 2.7 and above, as it has no dependencies.
-Its usage pattern is: `bin/rolling-pin COMMAND [-a --args]=ARGS [-h --help] [--dryrun]`
-### Commands
-| Command              | Description                                                         |
-| -------------------- | ------------------------------------------------------------------- |
-| build-package        | Build production version of repo for publishing                     |
-| build-prod           | Publish pip package of repo to PyPi                                 |
-| build-publish        | Run production tests first then publish pip package of repo to PyPi |
-| build-test           | Build test version of repo for prod testing                         |
-| docker-build         | Build image of rolling-pin                                          |
-| docker-build-prod    | Build production image of rolling-pin                               |
-| docker-container     | Display the Docker container id of rolling-pin                      |
-| docker-destroy       | Shutdown rolling-pin container and destroy its image                |
-| docker-destroy-prod  | Shutdown rolling-pin production container and destroy its image     |
-| docker-image         | Display the Docker image id of rolling-pin                          |
-| docker-prod          | Start rolling-pin production container                              |
-| docker-push          | Push rolling-pin production image to Dockerhub                      |
-| docker-remove        | Remove rolling-pin Docker image                                     |
-| docker-restart       | Restart rolling-pin container                                       |
-| docker-start         | Start rolling-pin container                                         |
-| docker-stop          | Stop rolling-pin container                                          |
-| docs                 | Generate sphinx documentation                                       |
-| docs-architecture    | Generate architecture.svg diagram from all import statements        |
-| docs-full            | Generate documentation, coverage report, diagram and code           |
-| docs-metrics         | Generate code metrics report, plots and tables                      |
-| library-add          | Add a given package to a given dependency group                     |
-| library-graph-dev    | Graph dependencies in dev environment                               |
-| library-graph-prod   | Graph dependencies in prod environment                              |
-| library-install-dev  | Install all dependencies into dev environment                       |
-| library-install-prod | Install all dependencies into prod environment                      |
-| library-list-dev     | List packages in dev environment                                    |
-| library-list-prod    | List packages in prod environment                                   |
-| library-lock-dev     | Resolve dev.lock file                                               |
-| library-lock-prod    | Resolve prod.lock file                                              |
-| library-remove       | Remove a given package from a given dependency group                |
-| library-search       | Search for pip packages                                             |
-| library-sync-dev     | Sync dev environment with packages listed in dev.lock               |
-| library-sync-prod    | Sync prod environment with packages listed in prod.lock             |
-| library-update       | Update dev dependencies                                             |
-| library-update-pdm   | Update PDM                                                          |
-| session-lab          | Run jupyter lab server                                              |
-| session-python       | Run python session with dev dependencies                            |
-| state                | State of rolling-pin                                                |
-| test-coverage        | Generate test coverage report                                       |
-| test-dev             | Run all tests                                                       |
-| test-fast            | Test all code excepts tests marked with SKIP_SLOWS_TESTS decorator  |
-| test-lint            | Run linting and type checking                                       |
-| test-prod            | Run tests across all support python versions                        |
-| version              | Full resolution of repo: dependencies, linting, tests, docs, etc    |
-| version-bump-major   | Bump pyproject major version                                        |
-| version-bump-minor   | Bump pyproject minor version                                        |
-| version-bump-patch   | Bump pyproject patch version                                        |
-| zsh                  | Run ZSH session inside rolling-pin container                        |
-| zsh-complete         | Generate oh-my-zsh completions                                      |
-| zsh-root             | Run ZSH session as root inside rolling-pin container                |
-### Flags
-| Short | Long      | Description                                          |
-| ----- | --------- | ---------------------------------------------------- |
-| -a    | --args    | Additional arguments, this can generally be ignored  |
-| -h    | --help    | Prints command help message to stdout                |
-| -     | --dryrun  | Prints command that would otherwise be run to stdout |

rolling_pin-0.9.5.dist-info/RECORD DELETED Viewed

@@ -1,15 +0,0 @@
-rolling_pin/__init__.py,sha256=R_g0FYses--dTmvbZLtFFI-FPn4og6p8zmkEesYmN1A,511
-rolling_pin/blob_etl.py,sha256=79eEeCZwPeJ8XwMlLp9-MywDwC-HlqMK-MJhksLrPdU,20712
-rolling_pin/command.py,sha256=xaM3Zp516sS2iF8RWb6qwGpc_IYmIkwtzJ2vDK9zPZo,6477
-rolling_pin/conform_config.py,sha256=W-Ps6FPuZ7SOxFOfEjIo2MZac1vCRuVky6samSZPQkw,2630
-rolling_pin/conform_etl.py,sha256=VyHAKVvdOtjx6Fy8dWn6XMfNh9OFgBbidyDUnSl3Zl4,9594
-rolling_pin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rolling_pin/radon_etl.py,sha256=SbGrRQM-exMBXiVmCL1ZThvxwLbZNL6URK6J97Ffdis,17681
-rolling_pin/repo_etl.py,sha256=QqPCaf_NKRvhEe-0ZZOL49kdTDmeJrAUBsEpMBF2Ccc,20399
-rolling_pin/toml_etl.py,sha256=fyioQTfqFW1e15qZ8F64sX379V5JzNlBKBuC5IPIgIo,4350
-rolling_pin/tools.py,sha256=OgjfFIrDe5ka7OPUyUC-hCSTXaPkDtxQyrf0jxNB0to,17530
-rolling_pin-0.9.5.dist-info/entry_points.txt,sha256=nbMiJnGLhp49xrtx1pjK8sJiBrwkpj2kq-ezp8Zfyyk,56
-rolling_pin-0.9.5.dist-info/WHEEL,sha256=B19PGBCYhWaz2p_UjAoRVh767nYQfk14Sn4TpIZ-nfU,87
-rolling_pin-0.9.5.dist-info/METADATA,sha256=sbNE4PPEC5pPtDeHLhJZQqCuTermuSJosvu23pjIfUw,14669
-rolling_pin-0.9.5.dist-info/licenses/LICENSE,sha256=uP7spBpmtZy9-ruxdJfwB8VVGaOYjxgtUfxwwQ3j0hU,1067
-rolling_pin-0.9.5.dist-info/RECORD,,

{rolling_pin-0.9.5.dist-info → rolling_pin-0.10.0.dist-info}/WHEEL RENAMED Viewed

File without changes

{rolling_pin-0.9.5.dist-info → rolling_pin-0.10.0.dist-info}/entry_points.txt RENAMED Viewed

File without changes

rolling-pin 0.9.5__py3-none-any.whl → 0.10.0__py3-none-any.whl

rolling-pin 0.9.5py3-none-any.whl → 0.10.0py3-none-any.whl