---
layout: page
---
For latest release notes please visit the [Releases page](https://github.com/johnmyleswhite/ProjectTemplate/releases) at GitHub.
Bleeding-edge development is reflected in the [ChangeLog](https://github.com/johnmyleswhite/ProjectTemplate/blob/master/ChangeLog) and in the [list of commits](https://github.com/johnmyleswhite/ProjectTemplate/commits/master):
The raw ProjectTemplate source code is always the place to go for ground truth.

The list of changes below covers all releases up to and including v0.8.2. It is not necessarily exhaustive.

#### 0.9.0 (2019-02-26)

###### Features

* New for R 3.6, support for staged install (#291)
* Define default table types using config var `tables_type` (#274)
* Support for `feather` files (#239)
* Migration from `csv2.reader` to `read.csv2` (#195)
* Supports `rstudio.project` files (#201)

##### Documentation

* Link website documentation current release to News.md
* Added file types to `dat` directory `README` (#268)
* Internal functions are now documenter (#243)

##### Internal

* `data_ignore` applies to `cache` vars (#290)
* More informative error messages if not in a ProjectTemplate Directory (#287)
* `migrate_project()` creates missing `cache` directory (#275)

#### 0.8.2 (2018-04-20)

##### Features

* Uses the Tidyverse packages (#207)
* Added custom templates (#206)
* Added support for rds files (#224, #227)


##### Documentation

* Documentation moved to `docs` folder.  Will automatically update on website

##### Internal

* Added tibble support (#218)
* Moved from `xls` package to `readxl` package (#159, #219)
* Allow overridng of globals (#222)
* Fixed failing test for `RSQLlite` package (#228)


#### 0.8.1 (2017-08-28)

##### Features

* Faster caching (#152, #155, #160, #166)
* New clear() function to manage global environment (#167, #172, #173, #183)
* New project.config() function and configuration help page (#164)
* Renamed doc to docs and added references to GitHub Pages configuration (#180)
* Added config option to treat the first row of a data file as header (current default) or not. (#168)
* Change csv2.reader() behavior to act as expected when running  read.csv2() (#195)
* Add list.data and incorporate in load.project (#187)

##### Documentation

##### Internal

* Moved logger initialisation to before loading helper functions, See issue #150
* Cleaner exit when running load.project() in the wrong directory (#157)
* Allow to call RSQLite's initExtension() (#161)
* Refactor migrate.project() and fix version tests (#162)
* Clean exit for more functions when current directory is not valid Project template (#163)
* Enable dcf files to contain R code that can be evaluated upon read (#169)
* Changed execution environment of CODE chunks (#171)
* Remove unused function .get.template.tar.path in create.project and old commented out code in load.project (#181)
* Uniform reading/writing global.dcf (#184)
* Ignore files in data directory (#178)
* Remove warnings from Travis and devtools::test() checks (#188)
* De-deprecated devtools installation command (#193)
* Bug Fix:  Missing hash file causes failure in subsequent cache() operation (#194)

#### 0.7 (2016-07-29)
 
##### Features

* `create.project()` creates `README.md` files in each subdirectory (#128). The README file in the main directory is now also formatted as Markdown, with the project name as title.
* Code that creates and runs tests now also allows non-R files in `libs` and `tests` subdirectories.
* Libraries from the `libraries` section are loaded before sourcing `lib/` files (#130).
* Missing packages are installed automatically (#146, @wilmeragsgh).
* Added `dplyr` to the list of default libraries in `global.dcf` (#143, @pavopax).
* `cache()` gains a new `...` argument which is passed to `save()` (#148, @eribul).
* Use `inherits = FALSE` in `get()` calls within specific environments (#139, @famuvie)
* The `port` option is now used for `RPostgreSQL` connections.

##### Documentation

* Update to getting-started/mastering documentation (#142, @matt-jay).
* Fix typo in error msg (#141, @famuvie).

##### Internal

* Isolate tests by using temporary directories and properly undoing `setwd()` calls (#132).
* `R CMD check` shows no errors, warnings, or notes.


#### v0.6 (2014-10-05)

* Includes all modifications from v0.5-3 and v0.5-2.

#### v0.5-3 (2014-10-05)

* Packages required for loading data sources are attached to the search path (with a warning) only if the new compatibility setting `attach_internal_libraries` is set to `TRUE`.  Attaching packages to the search path seems to be unnecessary to achieve proper functionality, but users might rely on this behavior, and so this is the default for migrated projects but turned off for new projects (#104).

#### v0.5-2 (2014-10-01)

##### Bug fixes

* Fixed error message when `require.package` is called from an anonymous
  function and fails to load a package.  (Using `deparse(nlines = 1)` now.)

##### Features

* Added functon `.add.extension()`. This allows users to create custom readers for extensions, either locally in a project or as packages.
* The configuration now stores the version of ProjectTemplate in the `version`
  field (#90).
* New function `migrate.project()` that allows upgrading a project to the
  current version of ProjectTemplate (#90, #121).
* New parameter `override.config` to `load.project()` and `reload.project()`
  allows substitution of individual configuration items (#76).
* Can use mustache style templating in SQL calls to access project data structures (#50).
* Support passwordless connection to postgresql databases (#115).
* Configuration entries that start with a hash (`#`) are silently ignored (#74).
* New variables `default.config` and `new.config` that store the default
  configuration used for missing configuration items or for a new project (#76, #89).
* Missing but required directories are now created (with a warning) (#76).
* Missing entries in the configuration file, or a missing configuration file,
  are substituted by defaults (with a warning).  Extra entries are ignored
  (with a warning) (#76).
* All logical configuration options are now stored as Boolean values instead of
  `'on'`/`'off'`.  Input values other than `'on'`/`'off'` are converted using
  `as.logical`, invalid values result in an error (#76).

##### Internal

* Dropped dependency on `Defaults` package (#100).
* Suppress warnings in tests (#111).
* Fix CRAN check issues (#117).
* Improved presentation of available readers in documentation (#119).

#### v0.5-1 (2014-03-17)

##### Bug fixes

* Restore compatibility to R 2.15.3 by avoiding use of the `no..` parameter
  to `list.files()` in our `create.project()` function.

#### v0.5 (2014-03-13)

##### Features

* New function `get.project()` to access `project.info`.
* Attempting to load a missing package when reading data will lead to a
 user-friendly error message (#26).
* Export existing `translate.dcf` function, useful for implementing custom readers (#59).
* Add new function `.add.extension.` This allows users to create custom readers
  for extensions, either locally in a project or as packages (#59).

##### Internal

* Fix CRAN warnings concerning use of `ProjectTemplate:::` qualification
  (#56).
* Fix CRAN warnings concerning assignments to `.GlobalEnv`.
* Updated author information in DESCRIPTION file (#40).
* Store templates for empty projects in tar files instead of storing
  the entire directory structure per CRAN request and to avoid having to build
  with the `--keep-empty-dirs` switch (#41).

#### v0.4-5 (2014-02-11)

* New maintainers: Kirill MÃ¼ller  <mail@kirill-mueller.de>, Kenton White  <jkentonwhite@gmail.com>
* Allow string interpolation of R functions in sql queries
* Added a JDBC database wrapper for accessing PostgreSQL databases hosted by Heroku (#20)
* JDBC connection can now use path to jar stored in CLASSPATH
* project.info is stored in the global environment again (reverted change from
  0.4-4); the active binding seemed to work for the tests but not from outside
  the package
* create.project now works if the directory exists. Merging with a non-empty
  directory is supported by setting the new parameter merge.strategy.

#### v0.4-4 (2013-08-11)

* Fix CRAN checks (@krlmlr).
* project.info is now an active binding to avoid writing to the global
  environment (@krlmlr).
* Reenabled xlsx.reader (@krlmlr).
* Added JDBC support to sql.reader (@joshbode, #12).
* Various MySQL improvements (@cortex, #10).
* Fix "Argument port must be an integer value" when using port number for mysql
  driver (@cortex, #7).
* Tentative CSV2 support.

#### v0.4-3 (2012-08-11)

* Added optional recursive data directory loading using a 'recursive_loading' setting.
* Added basic Oracle support (with tnsnames, no host/port) (@matteoredaelli, #6).

#### v0.4-2

* Had to disable xlsx.reader temporarily because it does not build for 2.15.

#### v0.4-1

* Added 'eda.R' example file in 'src/' directory.
* Allow loading from 'cache/' without loading from 'data/' through 'cache_loading' setting.
* Revised documentation.

#### v0.3-6

* Added Postgres support through RPostgreSQL
* Very rough ODBC support. See example in `ProjectTemplate:::sql.reader` documentation.
* `.dat` files are now read as if they were `.wsv` files.
* Revised documentation.

#### v0.3-5

* Added a `cache.project()` function.
* `as_factors` configuration option suppresses automatic character-to-factor conversion.
* Implemented `.zip` support using temporary files.
* Added `.mp3` support through the tuneR package.
* Added `.ppm` support through the pixmap package.
* `data_tables` configuration option automatically translates data sets into data.tables.
* Added unit tests for SPSS, Stata and SAS file formats.

#### v0.3-4

* Improved SQLite3 support:
  * Load all tables from SQLite3 database using a `.sql` file: set `table = "*"`
  * Load all tables from SQLite3 database automatically using `.db` extension.
* Added a .file type that can load files outside of the project directory.
* Renamed `run.tests()` to `test.project()`.
* Added a `stub.tests()` function that autogenerates tests for helper functions.
* Added a `show.project()` function that gives all known information about a project's internal state.

#### v0.3-3

* Added a `reload.project()` function.
* Improved error handling.
* Renamed `utilities.R` to `helpers.R`.
* Fixed a bug in `cache()`.

#### v0.3-2

* Added support for several new data formats.

#### v0.3-1

* Changed the configuration system from YAML to DCF format.
* Moved the data loading helper functions into separate files. They are no longer nested inside of `load.project()`.
* Started controlling which functions are exported using a NAMESPACE file.
* Added the ability to create minimal projects as well as the full projects that existing users will be familiar with.
* Switched all the `print()` calls to `message()` calls.
* Fixed a bug in cache().

#### v0.2-1

* Version 0.2-1 adds the following directories:
  * `cache`
  * `config`
  * `logs`
  * `munge`
  * `src`
* Inside the `config` directory, a global configuration file called `config/global.yaml` has been added that uses YAML syntax. This file provides the following configuration options:
  * `data_loading`: This can be set to 'on' or 'off'. If `data_loading` is on, the system will load data from both the `cache` and `data` directories with `cache` taking precedence in case of name conflict.
  * `munging`: This can be set to 'on' or 'off'. If `munging` is on, the system will execute the files in the `munge` directory sequentially. If `munging` is off, none of the files in the `munge` directory will be executed.
  * `logging`: This can be set to 'on' or 'off'. If `logging` is on, a logger object using the `log4r` package is automatically created when you run `load.project()`. This logger will write to the `logs` directory. By default, `logging` is off.
  * `load_libraries`: This can be set to 'on' or 'off'. If `load_libraries` is on, the system will load all of the R packages listed in the `libraries` field below.
  * `libraries`: This is a YAML array listing all of the packages that the user wants to automatically load when `load.project()` is called.
