NEWS.md

In caprice-j/ggbash: A Simpler Syntax for ggplot2

ggbash 0.4.7

New Feature

• ggbash::theme2() as an enhanced version of ggplot2::theme().

Bug fixes

• redundant element_*() and unit_*() handling
• make the return value of echo invisible()

ggbash 0.4.6

• several bug fixes

ggbash 0.4.5

Bug fixes

• handle two types of + signs in terminal mode
• Here I had to make a design choice. Now terminal-mdoe ggbash CANNOT contain whitespaces between aes names and values (i.e. Bad : size = 3 + .5 and Good: size=3+.5) This is because without parentheses and commas, there are almost no clues that differentiate between "ggplot2 plus" (connecting layers) and "R's plus" (an operator for addition). The hope is that in NSE mode ggbash can still include whitespaces between aes names and values. I hope this would not lead to users' frustration.
• handle redundant aes() specification (simply remove it)

ggbash 0.4.4

Bug fixes

• handle grouped_df case NSE in ggbash()
• add partial match preference when exact match (p should return p instead of price, even if the latter comes first)
• fix %>% and aes() case
• layer-specific data specification
• add . (dot) in parsing rules of variable names

ggbash 0.4.3

Enhancements

• handling of magritrr %>% operator
  • turned out to be harder than expected. ggplot2-compiler cannot recognize what . operator means, so the contents of . have to be properly set in temporary variable (ggbash_piped) in ggbash() and exec_ggbash().

ggbash 0.4.2

Bug Fixes

• handling of ..density.. or ..prop.. (four dots variables)
• handling of binwidth = c(1, 1)
• handling of group=1
• handling of internal stat_bin_hex
• add tests for geom_crossbar, geom_freqpoly, etc.

ggbash 0.4.1

Additional Features

• Non-standard evaluation (NSE) interface
• handling of x=1 (scalar variable)
• handling of R functions (turned out to be complicated)

Bug Fixes

• remove : in theme elements names and / in save_ggplot arguments. This is because or R's language restriction for more handy NSE. This supersede grammar rules determined in v0.2 change.

ggbash 0.4.0.9000

Major Updates

Approximate String Matching

• Approximate String Matching reduces programmer's stress because we usually type tokens only by its consonants.
  • aesthetics (size by sz)
  • theme configuration (legend.key by l.key, or legend.box.background by l.b.b)

Interface to other ggplot2 extensions

• The main scope of ggbash is to make a compiler for default ggplot2 functions. Handling ggplot2 extension libraries within ggbash() arguments should increase complexity and might significantly slows down the development process. As a remedy, ggbash() now returns a ggplot2 object (not a string) by ggbash(), and can chain other geom_ or theme_ objects by the normal + operator in ggplot2.
• Ex. ggbash("gg(iris, Sepal.W, Sepal.L) + point(col=Spec, size=5) ") + geom_text_repel(aes(label=Species))

Bug Fixes

• add docs tests of various geoms

ggbash 0.3.3 (2017-01-11)

Bug Fixes

• locate bin2d bins=10
• add syntax sugars (remove habitual commas and spaces)
• defaultZproblem (see by grep)
• start docs test of geom_countour, geom_point, and so on

ggbash 0.3.2 (2017-01-10)

Bug Fixes

• get stats (method="lm" in geom_smooth, binwidth=30 in geom_histogram) by get_stat_params
• get special flags like weight in geom_bar
• start docs test of geom_abline and geom_bar
• show colnames of previously-used data frame
• fix parentheses mismatch
  • one problem is unnecessary parentheses (legend.position = ("none") or panel.ontop = (TRUE))...
  • This is deceptively simple but hard to solve because of the current parsing production rules.
  • some rules can't know if element_text is placed before the current token.

ggbash 0.3.1 (2017-01-09)

Bug Fixes

• error handlings
  • missing required geoms gg mtcars + text mpg cyl
    • needed to rewrite production rules
  • special geom parameters (check_overlap, etc.)
  • general p_error

ggbash 0.3.0

Major Updates

Fixit

• From this v0.3.0, ggbash incorporates a powerful feature called fixit. It's inspired from a modern C++ compiler clang's Fix-It Hints. Now when ggbash users input a string which contains some typos, ggbash gives users useful information on what might be needed to fix the compile error.

  • For example, if users wrongly input the column name like gg iris + point Sepl.W Sepal.L, ggbash gives Column name not found error and also displays that the most similar column names are Sepal.Width, Species, Sepal.Length, Petal.Width, Petal.Length, in this order. This could significantly reduce the learning cost of ggplot2 and ggbash, having a possibility of making ggbash suitable for new ggplot2 users as well as its heavy users.

Other Bug Fixes

• checked coding style according to jimhester/lintr package.
• renamed partial_match_utils.R to prefix_match.R (more accurate)

ggbash 0.2.2 (2017-01-08)

• convert axis.ticks.length = 10 cm into grid::unit(10, 'cm') in theme()
• partial prefix match for theme element names

ggbash 0.2.1

• handle whitespaces of aesthetics before/after =
• default themes (theme_bw(), theme_classic(), ...) works by + theme bw or + theme_bw
• replace dplyr::tbl_df with more lightweight tibble::tibble
• handle character/logical classes of theme() elements
• refactor lexer.R and parser.R into ggplot2-compiler.R

ggbash 0.2

Major Updates

Implemented ggplot2::theme()

ggplot2::theme() is a powerful function that tweaks a lot of plot elements.

In this v0.2 release, most of the functions of theme are implemented.

It might need more test cases because of a lot of possibilities (such as a character variable), so the next a few weeks will be for fixing various bugs.

Copy of Internal Variable ggplot2:::.element_tree

Implementation of theme requires names and classes of theme elements like axis.text.x or legend.title.

As far as I researched, using ggplot2:::.element_tree seemed to be the best way to get those classes such as element_text or character.

But anyone can see in get_all_theme_aes implementation, this does not look a clean way to achieve that.

Design Decision of theme

One design decision I made and am not certain is to use : for separating theme's elements.

One example is:

theme(text = element_text(size=5, face="bold"), line = element_line(linetype='dotted'))
theme text:               size=5  face="bold"   line:               linetype='dotted'

The other ways I considered were as follows:

theme text  = size=5 face="bold"   line  = linetype="dotted"   # nested =
theme text := size=5 face="bold"   line := linetype="dotted"   # new operator :=
theme text(size=5, face="bold")    line(linetype="dotted")     # function-like parentheses
theme text(size=5  face="bold")    line(linetype="dotted")     # without commas

I could not decide which way is the best -- for me, all of the above options look violated principle of least astonishment.

But the implemented one lookedthe most intuitive, easy-to-learn, and easy-to-read at least among them. This decision will be easily changed by a more appealing alternative.

ggbash 0.1.1

Major Updates

rly (R clone of Lex and Yacc)

In the previous v0.1.0, all the tokenization/parsing/evaluation are interlaced, leading to possible hard maintainance and less readability.

In this v0.1.1 release, leveraging rly library's functionalities, most of the tokenization and parsing are separated into Ggplot2Lexer and Ggplot2Parser R6 objects.

Those two R6 objects are modularized just for ggplot2 grammars. i.e. tokenization and parsing of builtin ggbash commands such as copy, echo, or rm are still done by split_by_pipe() procedures.

This change resulted in removals of drawgg() and build_geom(), and all done in rly branch.

Adding new ggproto objects such as Scale or Coord now become adding new tokens in GGPLOT2_TOKENS and adding corresponding prodcution rules in Ggplot2Parser. This would enable much faster and less error-prone development process.

ggbash 0.1.0.9000

• first release

caprice-j/ggbash documentation built on May 13, 2019, 12:11 p.m.