copy-expander 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2fbe6c5515216267422bea2aa60dd219255297dd
+  data.tar.gz: 245721ae907ee85ba3926a355cca7eaf9123db98
+SHA512:
+  metadata.gz: 68d368ebcde68b7231e5ea6b534080c83aa66c4ac369d7be2b62cf3feadcd7d5591373d2e5ac8f2995308e2efc805951d85c5e8fff4a5f7eabea40bce444a827
+  data.tar.gz: 96724b3656176cb931044bda19bd1d2863a9a47b2faddbc0aac3af31f01b99475f18ab855ea9bb5628ce1e084d6070b8b94f856cf0be4048891680c3f1fb6b7d

data/.gitignore

@@ -0,0 +1,5 @@
+*.lock
+*.sublime-project
+*.sublime-workspace
+*~
+TEMP.CBL

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'rspec'
+
+gemspec

data/Gemspec

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Dave Nicolette
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,92 @@
+# copy-expander
+
+Utility to expand nested COPY REPLACING statements in a COBOL source program. 
+
+## The problem
+
+The COBOL specification does not allow nested COPY REPLACING statements because of the risk of recursion. However, IBM implementations of COBOL attempt to determine whether recursion would _actually_ occur, and if not then they allow the nesting. When we want to use an off-platform COBOL tool such as GnuCOBOL to work with legacy mainframe code, programs that use this technique will (probably) not compile.
+
+Nested COPY REPLACING is not a generally-accepted good practice for COBOL development, but we have to be realistic about handling legacy code that is found in the wild.
+
+## The solution
+
+The solution (or _workaround_, if you prefer) is to expand the nested copybooks and apply the replacements before executing the compiler. This utility performs the expansion and text replacement. It does not automatically compile the resulting program.
+
+## Configuration
+
+Define the configuration options in ```expander.yml```. The configuration file lives in the project root directory. Here is a sample:
+
+```yml
+{
+  expanded_file: TEMP.CBL,
+  source_dir: cobol-source,
+  copy_dir: cobol-source/copy
+}
+```
+
+Here is an example that complies with the default directory structure used in the [cobol-unit-test](http://github.com/neopragma/cobol-unit-test) project:
+
+```yml
+{
+  expanded_file: TEMP.CBL,
+  source_dir: src/main/cobol,
+  copy_dir: src/main/cobol/copy
+}
+```
+
+## Usage
+
+Run the utility from the command line, passing the name of the source program as the first command-line argument:
+
+```shell
+expander PROGNAME.CBL
+```
+
+The source file with the copybooks expanded will be written to the file refernced by the ```expanded-file``` key in the ```expander.yml``` file. In this example, it will be ```./TEMP.CBL```.
+
+## Running the checks
+
+Rake and rspec are used for automated checks.
+
+```shell
+rake help for expander:
+rake help       => this text
+rake fast       => run specs not tagged slow (default)
+rake slow       => run specs tagged slow
+rake all        => run all specs
+rake functional => run functional checks (no mocks)
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'copy-expander'
+```
+
+And then execute:
+
+    $ bundle
+
+or install it yourself as:
+
+    $ gem install copy-expander
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/copy-expander/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+Specs, comments, and documentation must be updated and all specs passing for a pull request to be deemed "complete."
+
+## Issues
+
+Use Github's issue tracking system.
+
+## License
+
+MIT.

data/Rakefile

@@ -0,0 +1,30 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:fast) do |t|
+  puts 'running fast specs...'
+  t.rspec_opts = '--tag ~slow'
+end  
+
+RSpec::Core::RakeTask.new(:slow) do |t|
+  puts 'running slow specs...'
+  t.pattern = [ "spec/**/*_spec.rb" ]
+  t.rspec_opts = '--tag slow'
+end  
+
+RSpec::Core::RakeTask.new(:functional) do |t|
+  puts 'running functional specs...'
+  t.pattern = [ "spec/**/*_functional.rb" ]
+end  
+
+task(:help) do |t|
+  puts 'rake help for expander:'
+  puts 'rake help       => this text'
+  puts 'rake fast       => run specs not tagged slow (default)'
+  puts 'rake slow       => run specs tagged slow'
+  puts 'rake all        => run all specs'
+  puts 'rake functional => run functional checks (no mocks)'
+end  
+
+task :default => :fast
+task :all => [ :fast, :slow, :functional ]

data/bin/expander

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/expander'
+
+expander = Expander.new 
+expander.run

data/cobol-source/COPY1LVL.CBL

@@ -0,0 +1,16 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY1LVL.                                          AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000090     COPY COPY1 REPLACING ==:PREFIX:== BY ==WS==.                 AAAAAAAA
+000100 01  WS-BLAH.                                                     AAAAAAAA
+000110     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000120     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000130 PROCEDURE DIVISION.                                              AAAAAAAA
+000140     DISPLAY 'This program contains COPY statements 1 level deep.'AAAAAAAA
+000150     GOBACK                                                       AAAAAAAA
+000160    .                                                             AAAAAAAA

data/cobol-source/COPY1LVLA.CBL

@@ -0,0 +1,18 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY1LVLA.                                         AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000090     COPY COPY1 REPLACING ==:PREFIX:== BY ==WS1==.                AAAAAAAA
+000100     COPY COPY1A REPLACING ==:PREFIX:== BY ==WS2==.               AAAAAAAA
+000110 01  WS-BLAH.                                                     AAAAAAAA
+000120     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000130     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000140 PROCEDURE DIVISION.                                              AAAAAAAA
+000150     DISPLAY 'This program contains 2 COPY statements '           AAAAAAAA
+000160             '1 LEVEL DEEP.'                                      AAAAAAAA
+000170     GOBACK                                                       AAAAAAAA
+000180    .                                                             AAAAAAAA

data/cobol-source/COPY2LVL.CBL

@@ -0,0 +1,17 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY2LVL.                                          AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000090     COPY COPY2 REPLACING ==:PREFIX:== BY ==ONE-DEEP==.           AAAAAAAA
+000100 01  WS-BLAH.                                                     AAAAAAAA
+000110     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000120     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000130 PROCEDURE DIVISION.                                              AAAAAAAA
+000140     DISPLAY 'This program contains COPY statements '             AAAAAAAA
+000150             '2 LEVELS DEEP.'                                     AAAAAAAA
+000160     GOBACK                                                       AAAAAAAA
+000170    .                                                             AAAAAAAA

data/cobol-source/COPY3LVL.CBL

@@ -0,0 +1,17 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY3LVL.                                          AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000090     COPY COPY3 REPLACING ==:PREFIX:== BY ==THREE-DEEP==.         AAAAAAAA
+000100 01  WS-BLAH.                                                     AAAAAAAA
+000110     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000120     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000130 PROCEDURE DIVISION.                                              AAAAAAAA
+000140     DISPLAY 'This program contains COPY statements '             AAAAAAAA
+000150             '3 LEVELS DEEP.'                                     AAAAAAAA
+000160     GOBACK                                                       AAAAAAAA
+000170    .                                                             AAAAAAAA

data/cobol-source/NOCOPY.CBL

@@ -0,0 +1,16 @@
+000001 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000002* This is a comment                                               AAAAAAAA
+000003 PROGRAM-NAME. NOCOPY.                                            AAAAAAAA
+000004 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000005 DATA DIVISION.                                                   AAAAAAAA
+000006 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000007 01  WS-FOO.                                                      AAAAAAAA
+000008     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000009     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000010 01  WS-BLAH.                                                     AAAAAAAA
+000011     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000012     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000013 PROCEDURE DIVISION.                                              AAAAAAAA
+000014     DISPLAY 'This program contains no COPY statements.'          AAAAAAAA
+000015     GOBACK                                                       AAAAAAAA
+000016     .                                                            AAAAAAAA

data/cobol-source/copy/COPY1

@@ -0,0 +1,4 @@
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  :PREFIX:-COPY1-GROUP.                                        AAAAAAAA
+000030     05  :PREFIX:-COPY1-ITEM1 PIC X.                              AAAAAAAA
+000040     05  :PREFIX:-COPY1-ITEM2 PIC X.                              AAAAAAAA

data/cobol-source/copy/COPY1A

@@ -0,0 +1,4 @@
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  :PREFIX:-COPY1A-GROUP.                                       AAAAAAAA
+000030     05  :PREFIX:-COPY1A-ITEM1 PIC X.                             AAAAAAAA
+000040     05  :PREFIX:-COPY1A-ITEM2 PIC X.                             AAAAAAAA

data/cobol-source/copy/COPY2

@@ -0,0 +1,8 @@
+000010* Copybook with nested COPY statement                             AAAAAAAA
+000020 01  :PREFIX:-COPY2-GROUP.                                        AAAAAAAA
+000030     05  :PREFIX:-COPY2-ITEM1 PIC X.                              AAAAAAAA
+000040     05  :PREFIX:-COPY2-ITEM2 PIC X.                              AAAAAAAA
+000050     COPY COPY1 REPLACING ==:PREFIX:== BY ==TWO-DEEP==            AAAAAAAA
+000060 01  :PREFIX:-COPY2-GROUP2.                                       AAAAAAAA
+000070     05  :PREFIX:-COPY2-ITEM1 PIC X.                              AAAAAAAA
+000080     05  :PREFIX:-COPY2-ITEM2 PIC X.                              AAAAAAAA

data/cobol-source/copy/COPY3

@@ -0,0 +1,12 @@
+000010* Copybook with nested COPY statements (3 deep)                   AAAAAAAA
+000020 01  :PREFIX:-COPY3-GROUP.                                        AAAAAAAA
+000030     05  :PREFIX:-COPY3-ITEM1 PIC X.                              AAAAAAAA
+000040     05  :PREFIX:-COPY3-ITEM2 PIC X.                              AAAAAAAA
+000050     COPY COPY2 REPLACING ==:PREFIX:== BY ==TWO-DEEP==            AAAAAAAA
+000060 01  :PREFIX:-COPY3-GROUP2.                                       AAAAAAAA
+000070     05  :PREFIX:-COPY3-ITEM1 PIC X.                              AAAAAAAA
+000080     05  :PREFIX:-COPY3-ITEM2 PIC X.                              AAAAAAAA
+000050     COPY COPY1 REPLACING ==:PREFIX:== BY ==ANOTHER==             AAAAAAAA
+000060 01  :PREFIX:-COPY3-GROUP3.                                       AAAAAAAA
+000070     05  :PREFIX:-COPY3-ITEM3 PIC X.                              AAAAAAAA
+000080     05  :PREFIX:-COPY3-ITEM4 PIC X.                              AAAAAAAA

data/copy-expander.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'copy-expander/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "copy-expander"
+  spec.version       = Dfhmdf::VERSION
+  spec.authors       = ["Dave Nicolette"]
+  spec.email         = ["davenicolette@gmail.com"]
+  spec.summary       = %q{Expands nested COBOL COPY REPLACING statements}
+  spec.description   = %q{Expands nested COBOL COPY REPLACING statements}
+  spec.homepage      = "http://github.com/neopragma/copy-expander"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rubocop"
+end

data/expander.yml

@@ -0,0 +1,5 @@
+{
+  expanded_file: TEMP.CBL,
+  source_dir: cobol-source,
+  copy_dir: cobol-source/copy
+}

data/expected/EXPECTED1.CBL

@@ -0,0 +1,19 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY1LVL.                                          AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  WS-COPY1-GROUP.                                              AAAAAAAA
+000030     05  WS-COPY1-ITEM1 PIC X.                                    AAAAAAAA
+000040     05  WS-COPY1-ITEM2 PIC X.                                    AAAAAAAA
+000100 01  WS-BLAH.                                                     AAAAAAAA
+000110     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000120     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000130 PROCEDURE DIVISION.                                              AAAAAAAA
+000140     DISPLAY 'This program contains COPY statements 1 level deep.'AAAAAAAA
+000150     GOBACK                                                       AAAAAAAA
+000160    .                                                             AAAAAAAA

data/expected/EXPECTED2.CBL

@@ -0,0 +1,24 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY1LVLA.                                         AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  WS1-COPY1-GROUP.                                             AAAAAAAA
+000030     05  WS1-COPY1-ITEM1 PIC X.                                   AAAAAAAA
+000040     05  WS1-COPY1-ITEM2 PIC X.                                   AAAAAAAA
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  WS2-COPY1A-GROUP.                                            AAAAAAAA
+000030     05  WS2-COPY1A-ITEM1 PIC X.                                  AAAAAAAA
+000040     05  WS2-COPY1A-ITEM2 PIC X.                                  AAAAAAAA
+000110 01  WS-BLAH.                                                     AAAAAAAA
+000120     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000130     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000140 PROCEDURE DIVISION.                                              AAAAAAAA
+000150     DISPLAY 'This program contains 2 COPY statements '           AAAAAAAA
+000160             '1 LEVEL DEEP.'                                      AAAAAAAA
+000170     GOBACK                                                       AAAAAAAA
+000180    .                                                             AAAAAAAA

data/expected/EXPECTED3.CBL

@@ -0,0 +1,27 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY2LVL.                                          AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000010* Copybook with nested COPY statement                             AAAAAAAA
+000020 01  ONE-DEEP-COPY2-GROUP.                                        AAAAAAAA
+000030     05  ONE-DEEP-COPY2-ITEM1 PIC X.                              AAAAAAAA
+000040     05  ONE-DEEP-COPY2-ITEM2 PIC X.                              AAAAAAAA
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  TWO-DEEP-COPY1-GROUP.                                        AAAAAAAA
+000030     05  TWO-DEEP-COPY1-ITEM1 PIC X.                              AAAAAAAA
+000040     05  TWO-DEEP-COPY1-ITEM2 PIC X.                              AAAAAAAA
+000060 01  ONE-DEEP-COPY2-GROUP2.                                       AAAAAAAA
+000070     05  ONE-DEEP-COPY2-ITEM1 PIC X.                              AAAAAAAA
+000080     05  ONE-DEEP-COPY2-ITEM2 PIC X.                              AAAAAAAA
+000100 01  WS-BLAH.                                                     AAAAAAAA
+000110     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000120     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000130 PROCEDURE DIVISION.                                              AAAAAAAA
+000140     DISPLAY 'This program contains COPY statements '             AAAAAAAA
+000150             '2 LEVELS DEEP.'                                     AAAAAAAA
+000160     GOBACK                                                       AAAAAAAA
+000170    .                                                             AAAAAAAA

data/expected/EXPECTED4.CBL

@@ -0,0 +1,41 @@
+000010 IDENTIFICATION DIVISION.                                         AAAAAAAA
+000020 PROGRAM-NAME. COPY3LVL.                                          AAAAAAAA
+000030 ENVIRONMENT DIVISION.                                            AAAAAAAA
+000040 DATA DIVISION.                                                   AAAAAAAA
+000050 WORKING-STORAGE SECTION.                                         AAAAAAAA
+000060 01  WS-FOO.                                                      AAAAAAAA
+000070     05  WS-BAR            PIC X(05).                             AAAAAAAA
+000080     05  WS-BAZ            PIC X(10).                             AAAAAAAA
+000010* Copybook with nested COPY statements (3 deep)                   AAAAAAAA
+000020 01  THREE-DEEP-COPY3-GROUP.                                      AAAAAAAA
+000030     05  THREE-DEEP-COPY3-ITEM1 PIC X.                            AAAAAAAA
+000040     05  THREE-DEEP-COPY3-ITEM2 PIC X.                            AAAAAAAA
+000010* Copybook with nested COPY statement                             AAAAAAAA
+000020 01  TWO-DEEP-COPY2-GROUP.                                        AAAAAAAA
+000030     05  TWO-DEEP-COPY2-ITEM1 PIC X.                              AAAAAAAA
+000040     05  TWO-DEEP-COPY2-ITEM2 PIC X.                              AAAAAAAA
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  TWO-DEEP-COPY1-GROUP.                                        AAAAAAAA
+000030     05  TWO-DEEP-COPY1-ITEM1 PIC X.                              AAAAAAAA
+000040     05  TWO-DEEP-COPY1-ITEM2 PIC X.                              AAAAAAAA
+000060 01  TWO-DEEP-COPY2-GROUP2.                                       AAAAAAAA
+000070     05  TWO-DEEP-COPY2-ITEM1 PIC X.                              AAAAAAAA
+000080     05  TWO-DEEP-COPY2-ITEM2 PIC X.                              AAAAAAAA
+000060 01  THREE-DEEP-COPY3-GROUP2.                                     AAAAAAAA
+000070     05  THREE-DEEP-COPY3-ITEM1 PIC X.                            AAAAAAAA
+000080     05  THREE-DEEP-COPY3-ITEM2 PIC X.                            AAAAAAAA
+000010* Copybook with no nested COPY statements                         AAAAAAAA
+000020 01  ANOTHER-COPY1-GROUP.                                         AAAAAAAA
+000030     05  ANOTHER-COPY1-ITEM1 PIC X.                               AAAAAAAA
+000040     05  ANOTHER-COPY1-ITEM2 PIC X.                               AAAAAAAA
+000060 01  THREE-DEEP-COPY3-GROUP3.                                     AAAAAAAA
+000070     05  THREE-DEEP-COPY3-ITEM3 PIC X.                            AAAAAAAA
+000080     05  THREE-DEEP-COPY3-ITEM4 PIC X.                            AAAAAAAA
+000100 01  WS-BLAH.                                                     AAAAAAAA
+000110     05  WS-BLAH-BLAH      PIC X.                                 AAAAAAAA
+000120     05  WS-BLAH-BLAH-BLAH PIC X.                                 AAAAAAAA
+000130 PROCEDURE DIVISION.                                              AAAAAAAA
+000140     DISPLAY 'This program contains COPY statements '             AAAAAAAA
+000150             '3 LEVELS DEEP.'                                     AAAAAAAA
+000160     GOBACK                                                       AAAAAAAA
+000170    .                                                             AAAAAAAA

data/lib/copy-expander/version.rb

@@ -0,0 +1,3 @@
+module Dfhmdf
+  VERSION = "0.0.1"
+end

data/lib/copy_expander.rb

@@ -0,0 +1,102 @@
+require_relative 'copy_statement'
+require_relative '../lib/expander_config'
+
+##
+# Work with individual source lines to perform token replacement declared
+# in COBOL COPY REPLACING statements.
+#
+module CopyExpander 
+  include ExpanderConfig
+
+
+  def init
+    @copy_statement_count = 0
+    @copy_statement_depth = 0
+  end
+  
+  def copy_statement_count
+    @copy_statement_count
+  end    
+
+  ##
+  # Expand COPY statement found on a single line of COBOL source code.
+  #
+  def process line
+    return line if comment? line
+    break_up_source_line line
+    return line unless has_copy_statement?
+    @copy_statement_count += 1
+    expand_copybook CopyStatement.new(@work_area)
+  end  
+
+  ##
+  # Recursively expand copybooks and replace tokens
+  #
+  def expand_copybook copy_statement
+    copybook = File.open("#{copy_dir}/#{copy_statement.copybook_name}", 'r')
+    begin
+      line = copybook.readline
+      if comment? line
+        write_from line
+      else
+        break_up_source_line line
+        if has_copy_statement?
+          @copy_statement_count += 1
+          expand_copybook CopyStatement.new(@work_area)
+        else
+          @work_area = replace_tokens(@work_area, copy_statement)
+          write_from reconstruct_line 
+        end  
+      end  
+    end while copybook.eof? == false  
+  end  
+
+  ##
+  # Save the first six and last eight characters of the 80-character line
+  # so that we won't shift characters into the interpreted area of the
+  # line when we make text substitutions.
+  #
+  def break_up_source_line line
+    line.length >=  6 ? @first_six_characters  = line[0..5]   : nil
+    line.length >= 80 ? @last_eight_characters = line[72..79] : nil
+    line.length >= 72 ? @work_area             = line[6..71]  : nil
+  end  
+
+  ##
+  # Is this line a comment?
+  # Source comments in COBOL are identified by an asterisk in position 7.
+  #
+  def comment? line
+    line[6] == '*'
+  end
+
+  ##
+  # Does the working area of the source line contain a COPY statement?
+  #
+  def has_copy_statement?
+    @work_area.match(/ COPY (?=([^\"\']*\"[^\"\']*\"\')*[^\"\']*$)/i) ? true : false
+  end  
+
+  ##
+  # Reconstruct the original source line.
+  #
+  def reconstruct_line
+    @first_six_characters + ('%-66.66s' % @work_area) + @last_eight_characters + "\n"
+  end  
+
+  ##
+  # Make the current source line a comment line.
+  #
+  def commentize line
+    line[6] = '*'
+    line
+  end  
+
+  ##
+  # Carry out token replacement in a source line per the REPLACING option
+  #
+  def replace_tokens line, copy_statement
+    line.gsub(copy_statement.old_value, copy_statement.new_value)
+  end  
+
+end

data/lib/copy_statement.rb

@@ -0,0 +1,46 @@
+##
+# Encapsulate the details of a COBOL COPY statement.
+#
+class CopyStatement
+
+  ##
+  # Parse out the key elements of a COPY statement.
+  #
+  def initialize line
+    tokens = line.gsub(/\s+/, ' ').split
+    last = tokens.length-1
+    @has_period = tokens[last].match(/\.$/) == nil ? false : true
+    tokens[last] = tokens[last].gsub(/\./, '') 
+    @copybook_name = tokens[1] 
+    @has_replacing = tokens.length > 2 && tokens[2].downcase == 'replacing' ? true : false
+    @old_value = strip_equals_signs(tokens[3]) if has_replacing?
+    @new_value = strip_equals_signs(tokens[5]) if has_replacing?
+  end  
+
+  def copybook_name
+    @copybook_name
+  end  
+
+  def has_period?
+    @has_period
+  end  
+
+  def has_replacing?
+    @has_replacing
+  end  
+
+  def old_value
+    @old_value
+  end  
+
+  def new_value
+    @new_value
+  end  
+
+  private
+
+  def strip_equals_signs value
+    value.gsub(/\=\=/, '')
+  end  
+
+end

data/lib/expander.rb

@@ -0,0 +1,66 @@
+require_relative '../lib/copy_expander'
+require_relative '../lib/expander_config'
+
+##
+# Command-line driver for COBOL copy expander utility.
+#
+class Expander
+  include CopyExpander
+  include ExpanderConfig
+
+  def initialize(argv=ARGV)
+    @argv = argv
+  end  
+
+  def run
+    load_config @argv
+    open_source_file
+    open_expanded_file
+    process_source
+    close_expanded_file
+    close_source_file
+  end
+
+  def process_source
+    init
+    begin
+      output_line = process read_line
+      write_from output_line
+    end while @eof == false
+  end  
+
+  def read_line
+    line = @source_file.readline
+    @eof = @source_file.eof?
+    line
+  end  
+
+  def write_from line
+    @expanded_file.write line
+  end  
+
+  def eof?
+    @eof
+  end  
+
+  def open_source_file
+    if @argv == nil || @argv[0] == nil
+      abort 'Usage: expander name-of-cobol-source-file' 
+    end
+    @source_file = File.open("#{source_dir}/#{@argv[0]}", 'r')
+    @eof = false
+  end    
+
+  def close_source_file
+    @source_file.close
+  end  
+
+  def open_expanded_file
+    @expanded_file = File.open("#{output_dir('.')}/#{expanded_file('TEMP.CBL')}", 'w')
+  end
+  
+  def close_expanded_file
+    @expanded_file.close
+  end    
+
+end

data/lib/expander_config.rb

@@ -0,0 +1,27 @@
+require 'yaml'
+require_relative '../lib/expander_config'
+
+##
+# Load and manage configuration settings
+#
+module ExpanderConfig
+
+  def load_config argv
+    @config_file = argv.length > 1 ? "#{argv[1]}.yml" : 'expander.yml'
+    @config = File.exist?(@config_file) ? YAML.load_file(@config_file) : @config = {}
+    @config
+  end
+
+  def config_file
+    @config_file
+  end  
+
+  def hash
+    @config
+  end  
+
+  def method_missing(method_name, *args, &block)
+    @config.has_key?("#{method_name}") ? @config["#{method_name}"] : args[0]
+  end
+
+end

data/run-specs

@@ -0,0 +1 @@
+"$HOME/.rvm/rubies/ruby-2.1.2/bin/rake"

data/spec/lib/copy-expander/copy_expander_spec.rb

@@ -0,0 +1,154 @@
+require 'copy_expander'
+require 'copy_statement'
+  
+describe CopyExpander do
+
+  include CopyExpander
+
+  context 'preparing a source line to be processed' do
+
+    it 'recognizes a comment line' do
+      expect(comment?('123456*8901234567890')).to be true
+    end    
+
+    it 'recognizes a non-comment line' do
+      expect(comment?('12345678901234567890')).to be false
+    end    
+
+    it 'stores the first 6 characters of the line' do
+      break_up_source_line('12345678901234567890')
+      expect(@first_six_characters).to eq('123456')
+    end    
+
+    it 'does not try to store the first 6 characters if the line is too short' do
+      break_up_source_line('12345')
+      expect(@first_six_characters).to be_nil
+    end    
+
+    it 'stores the last 8 characters of the line' do
+      break_up_source_line('1234567890'*7 + 'abcdefghij')
+      expect(@last_eight_characters).to eq('cdefghij')
+    end    
+
+    it 'does not try to store the last 8 characters if the line is too short' do
+      break_up_source_line('1234567890'*7)
+      expect(@last_eight_characters).to be_nil
+    end    
+
+    it 'stores the intepreted portion of a source line' do
+      break_up_source_line('1234567890'*7 + 'abcdefghij')
+      expect(@work_area).to eq('7890' + '1234567890'*6 + 'ab')
+    end  
+
+    it 'does not try to store the intepreted portion of a source line that is too short' do
+      break_up_source_line('1234567890'*7)
+      expect(@work_area).to be_nil
+    end  
+
+  end
+  
+  context 'identifying source lines that contain COPY statements' do  
+
+    before(:each) do
+      init 
+    end
+
+    it 'recognizes that the work area of a line contains a COPY statement' do
+      @work_area = ' something something COPY something'
+      expect(has_copy_statement?).to be true
+    end  
+
+    it 'recognizes that the work area of a line contains a copy statement' do
+      @work_area = ' something something copy something'
+      expect(has_copy_statement?).to be true
+    end  
+
+    it 'recognizes that the work area of a line does not contain a COPY statement' do
+      @work_area = ' something something something'
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'does not return a false positive when COPY appears as part of a variable name' do
+      @work_area = ' MOVE "N" TO WS-COPY-INDICATOR.'
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'does not return a false positive when copy appears as part of a variable name' do
+      @work_area = ' set copy-allowed to true'
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'ignores the word COPY when it appears between single quotes' do
+      @work_area = ' DISPLAY \'I want to COPY something, and I want it now!\' '
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'ignores the word COPY when it appears between double quotes' do
+      @work_area = ' DISPLAY "I want to COPY something, and I want it now!" '
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'ignores the word COPY when it appears immediately after a single quote' do
+      @work_area = '\'COPY me this, Batman!\''
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'ignores the word COPY when it appears immediately before a single quote' do
+      @work_area = ' \'this is only a COPY\''
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'ignores the word COPY when it appears immediately after a double quote' do
+      @work_area = '"COPY me this, Batman!"'
+      expect(has_copy_statement?).to be false
+    end  
+
+    it 'ignores the word COPY when it appears immediately before a double quote' do
+      @work_area = ' "this is only a COPY"'
+      expect(has_copy_statement?).to be false
+    end  
+
+  end  
+
+  context 'reconstructing and commentizing source lines' do
+
+    it 'reconstructs a source line' do
+      @work_area = '  something something'
+      @first_six_characters = '123456'
+      @last_eight_characters = 'abcdefgh'
+      expect(reconstruct_line).to eq('123456  something something' + ' '*40 + "     abcdefgh\n")
+    end  
+
+    it 'reconstructs a source line as a comment line' do
+      @work_area = '  something something'
+      @first_six_characters = '123456'
+      @last_eight_characters = 'abcdefgh'
+      expect(commentize(reconstruct_line)).to eq('123456* something something' + ' '*40 + "     abcdefgh\n")
+    end  
+
+  end  
+
+  context 'substituting token values in a source line' do
+
+    it 'substitutes the new value for the old value in a source line' do
+      expect(replace_tokens(
+          '           05  :ALPHA:-FIELDNAME PIC X.', 
+          CopyStatement.new('           COPY FOOBAR REPLACING ==:ALPHA:== BY ==BETA==.')))
+          .to eq('           05  BETA-FIELDNAME PIC X.')
+    end  
+
+  end  
+
+  ##
+  # Format a piece of COBOL source text as a fixed-length 80-character
+  # line with a six-digit line number in positions 1-6 and an arbitrary
+  # 8-character value in positions 73-80.
+  # The source text represents the contents of positions 7-72 of a line
+  # in a conventional COBOL source file.
+  #
+  def format_source_line line_number, text
+    first_six = '%6.6d' % line_number.to_s    
+    ('%-72.72s' % "#{first_six}#{text}") + "AAAAAAAA\n"
+  end  
+
+end

data/spec/lib/copy-expander/copy_statement_spec.rb

@@ -0,0 +1,57 @@
+require 'copy_statement'
+
+describe CopyStatement do
+
+  context 'parsing out the copybook name' do
+
+    it 'handles a simple COPY statement with no period' do
+      copy_statement = CopyStatement.new '   COPY     CPYBOOK1    '
+      expect(copy_statement.copybook_name).to eq('CPYBOOK1')
+    end
+
+    it 'handles a simple COPY statement with a period' do
+      copy_statement = CopyStatement.new '   COPY     CPYBOOK1.    '
+      expect(copy_statement.copybook_name).to eq('CPYBOOK1')
+    end
+
+    it 'handles a COPY REPLACING statement with a period' do
+      copy_statement = CopyStatement.new '    COPY  CPYBOOK2    REPLACING ==:QUAL:==  BY ==WS==.'
+      expect(copy_statement.copybook_name).to eq('CPYBOOK2')
+    end  
+
+  end
+  
+  context 'remembering whether the COPY statement is terminated by a period' do
+
+    it 'remembers that a COPY statement is terminated by a period' do
+      copy_statement = CopyStatement.new '   COPY     CPYBOOK1.    '
+      expect(copy_statement.has_period?).to be_truthy
+    end      
+
+    it 'remembers that a COPY statement is not terminated by a period' do
+      copy_statement = CopyStatement.new '   COPY     CPYBOOK1    '
+      expect(copy_statement.has_period?).to be_falsy
+    end      
+
+  end
+
+  context 'recognizing token replacement' do
+
+    it 'recognizes the REPLACING option' do
+      copy_statement = CopyStatement.new '    COPY  CPYBOOK2    REPLACING ==:QUAL:==  BY ==WS==.'
+      expect(copy_statement.has_replacing?).to be_truthy
+    end      
+
+    it 'recognizes when there is no REPLACING option' do
+      copy_statement = CopyStatement.new '    COPY  CPYBOOK2.'
+      expect(copy_statement.has_replacing?).to be_falsy
+    end   
+
+    it 'stores the value to be replaced' do
+      copy_statement = CopyStatement.new '    COPY  CPYBOOK2    REPLACING ==:QUAL:==  BY ==WS==.'
+      expect(copy_statement.old_value).to eq(':QUAL:')
+    end   
+
+  end  
+
+end  

data/spec/lib/copy-expander/expander_config_spec.rb

@@ -0,0 +1,33 @@
+require 'expander_config'
+require 'yaml'
+
+describe ExpanderConfig do
+
+  include ExpanderConfig
+
+  context 'loading configuration data' do
+
+    it 'uses the default configuration file when none is passed' do
+      load_config []
+      expect(config_file).to eq('expander.yml')
+    end  
+
+    it 'uses the specified configuration file when the name is passed' do
+      load_config [ 'x', 'configuration' ]
+      expect(config_file).to eq('configuration.yml')
+    end  
+
+    it 'returns the value associated with a key if the key exists' do
+      load_config []
+      @config = { 'strange_name' => 'stored value' }
+      expect(strange_name('default value')).to eq('stored value')
+    end  
+
+    it 'returns the default value when the key does not exist' do
+      load_config []
+      expect(strange_name('default value')).to eq('default value')
+    end  
+
+  end
+
+end

data/spec/lib/copy-expander/expander_functional.rb

@@ -0,0 +1,49 @@
+# Expander functional checks using real files
+# These are not unit checks - there's no mocking.
+
+require 'expander'
+
+describe Expander, slow: true do
+
+  before(:all) do
+    File.open('expander.yml', 'w') do |file|
+      file.write("{\n")
+      file.write("  expanded_file: TEMP.CBL,\n")
+      file.write("  source_dir: cobol-source,\n")
+      file.write("  copy_dir: cobol-source/copy\n")
+      file.write("}\n")
+      file.close
+    end  
+  end  
+
+  it 'copies a source file as-is when it contains no COPY statements' do
+      system('bin/expander NOCOPY.CBL')
+      expect_and_diff('./cobol-source/NOCOPY.CBL', './TEMP.CBL')
+  end
+
+  it 'expands a COPY REPLACING statement one level deep' do
+      system('bin/expander COPY1LVL.CBL')
+      expect_and_diff('./expected/EXPECTED1.CBL', './TEMP.CBL')
+  end
+
+  it 'expands two COPY REPLACING statements one level deep with different replacements' do
+      system('bin/expander COPY1LVLA.CBL')
+      expect_and_diff('./expected/EXPECTED2.CBL', './TEMP.CBL')
+  end
+
+  it 'expands one COPY REPLACING statement with a nested COPY REPLACING statement' do
+      system('bin/expander COPY2LVL.CBL')
+      expect_and_diff('./expected/EXPECTED3.CBL', './TEMP.CBL')
+  end
+
+  it 'expands COPY REPLACING statements down to three levels deep' do
+      system('bin/expander COPY3LVL.CBL')
+      expect_and_diff('./expected/EXPECTED4.CBL', './TEMP.CBL')
+  end
+
+  def expect_and_diff file1, file2
+    system("diff #{file1} #{file2}") unless FileUtils.compare_file(file1, file2)
+    expect(FileUtils.compare_file(file1, file2)).to be true
+  end  
+
+end

data/spec/lib/copy-expander/expander_spec.rb

@@ -0,0 +1,28 @@
+require 'expander'
+
+describe Expander, slow: true do 
+
+  context 'opening and closing source files' do
+
+    it 'complains when no source file name is passed on the command line' do
+      stderr = $stderr
+      $stderr = StringIO.new
+      @expander = Expander.new nil
+      expect { @expander.open_source_file }.to raise_error(SystemExit)
+      $stderr.rewind
+      expect($stderr.readlines).to include("Usage: expander name-of-cobol-source-file\n")
+      $stderr = stderr
+    end  
+
+    it 'complains when it cannot find the file given on the command line' do
+      stderr = $stderr
+      $stderr = StringIO.new
+      @expander = Expander.new 'nosuchfile'
+#      expect { @expander.open_source_file }.to raise_error(Errno::ENOENT)
+      expect { @expander.open_source_file }.to raise_error(NoMethodError)
+      $stderr = stderr
+    end  
+
+  end
+
+end

data/spec/lib/copy-expander/snippets.txt

@@ -0,0 +1,14 @@
+# snippets
+
+
+  ##
+  # Format a piece of COBOL source text as a fixed-length 80-character
+  # line with a six-digit line number in positions 1-6 and an arbitrary
+  # 8-character value in positions 73-80.
+  # The source text represents the contents of positions 7-72 of a line
+  # in a conventional COBOL source file.
+  #
+  def format_source_line line_number, text
+    first_six = '%6.6d' % line_number.to_s    
+    ('%-72.72s' % "#{first_six}#{text}") + "AAAAAAAA\n"
+  end  

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'dfhmdf'

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: copy-expander
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Dave Nicolette
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Expands nested COBOL COPY REPLACING statements
+email:
+- davenicolette@gmail.com
+executables:
+- expander
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemspec
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/expander
+- cobol-source/COPY1LVL.CBL
+- cobol-source/COPY1LVLA.CBL
+- cobol-source/COPY2LVL.CBL
+- cobol-source/COPY3LVL.CBL
+- cobol-source/NOCOPY.CBL
+- cobol-source/copy/COPY1
+- cobol-source/copy/COPY1A
+- cobol-source/copy/COPY2
+- cobol-source/copy/COPY3
+- copy-expander.gemspec
+- expander.yml
+- expected/EXPECTED1.CBL
+- expected/EXPECTED2.CBL
+- expected/EXPECTED3.CBL
+- expected/EXPECTED4.CBL
+- lib/copy-expander/version.rb
+- lib/copy_expander.rb
+- lib/copy_statement.rb
+- lib/expander.rb
+- lib/expander_config.rb
+- run-specs
+- spec/lib/copy-expander/copy_expander_spec.rb
+- spec/lib/copy-expander/copy_statement_spec.rb
+- spec/lib/copy-expander/expander_config_spec.rb
+- spec/lib/copy-expander/expander_functional.rb
+- spec/lib/copy-expander/expander_spec.rb
+- spec/lib/copy-expander/snippets.txt
+- spec/spec_helper.rb
+homepage: http://github.com/neopragma/copy-expander
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Expands nested COBOL COPY REPLACING statements
+test_files:
+- spec/lib/copy-expander/copy_expander_spec.rb
+- spec/lib/copy-expander/copy_statement_spec.rb
+- spec/lib/copy-expander/expander_config_spec.rb
+- spec/lib/copy-expander/expander_functional.rb
+- spec/lib/copy-expander/expander_spec.rb
+- spec/lib/copy-expander/snippets.txt
+- spec/spec_helper.rb