trailblazer 1.1.1 → 2.1.0

data/CHANGES.md

@@ -1,3 +1,227 @@
+# 2.1
+
+* Macros now always have to provide an `:id`. This was a bit fuzzy in 2.0.
+
+* Nested
+  if Nested( Edit ), outputs will automatically be connected, see editor.
+* Wrap
+  dropped the `pipe` option. This is now `options, flow_options, *`
+  `false` is now automatically connected to End.failure.
+* remove `Uber::Callable`.
+
+* `operation.new` step removed.
+* Undocumented step behavior removed. You can't write to `self` anymore.
+
+        ```ruby
+        step :process
+        def process(*)
+          self["x"] = true
+        end
+        ```
+
+    Always write to `options`.
+
+* self[] removed
+* Fixed `Guard` where procs could receive one argument, only. Guards follow the step interface: `Policy::Guard( ->(options, **) { .. } )
+* Removed `Operation::Callback` which was a poor idea and luckily no one was using it.
+
+TODO:
+document Task API and define step API
+deprecate step->(options) ?
+injectable, per-operation step arguments strategy?
+
+
+# 2.1.0
+
+* Remove `declarative` dependency.
+
+# 2.1.0.rc13
+
+* Use newest `macro` and `macro-context`.  They use symbols keys now everywhere.
+
+# 2.1.0.rc12
+
+* Update dependencies.
+
+# 2.1.0.rc11
+
+* Remove all macros. They're not located in `trailblazer-macro` and `trailblazer-macro-contract`.
+* Remove DSL
+
+# 2.1.0.rc1
+
+* Remove `task` and `input_output`, those are implemented in `activity`.
+
+# 2.1.0.beta7
+
+* Use new `activity-0.3.2` where `VariableMapping` is included now.
+
+# 2.1.0.beta6
+
+* Use new `activity-0.3.0`.
+
+# 2.1.0.beta5
+
+* All macros are now cleanly extracted to `trailblazer-macro` and `trailblazer-macro-contract`.
+
+# 2.1.0.beta4
+
+* Simple maintenance release to establish `activity-0.5.0`.
+
+# 2.1.0.beta3
+
+* More simplifications because of `activity`.
+
+# 2.1.0.beta2
+
+* Simplify `Nested` and several other internals by using the new `Activity` API.
+
+# 2.1.0.beta1
+
+* Add `deprecation/call` and `deprecation/context` that help with the new `call` API and symbols for `options` keys.
+
+# 2.0.7
+
+* Allow to use any method with the Model macro, e.g.
+
+    ```ruby
+    step Model( Comment, :[] )
+    ```
+
+  will now invoke `Comment[ params[:id] ]`, which makes using Sequel a breeze.
+ code: `contract do .. end` etc needs to be moved to a new gem if we want to keep it alive.
+
+# 2.0.6
+
+* Fix what we broke in 2.0.5, where `Wrap` would always use the current operation subclass and not the empty `Trailblazer::Operation`. Thanks to @mensfeld.
+
+# 2.0.5
+
+* In Wrap, use `self` instead of a hard class reference. This allows using Wrap in the compat gem.
+
+# 2.0.4
+
+* When using `Nested(X)`, the automatic `:name` option is now `"Nested(X)"` instead of the cryptic proc string.
+
+# 2.0.3
+
+* `Guard` now allows kw args for its option.
+* Fix a bug where `Nested( ->{} )` wouldn't `_call` the nested operation and did too much work on re-nested the already nested params. Thanks to @eliranf for spotting this.
+* Add `Nested(..., input: )` to dynamically decide the input to the nested operation. http://trailblazer.to/gems/operation/2.0/api.html#nested-input
+* Add `Nested(..., output: )`: http://trailblazer.to/gems/operation/2.0/api.html#nested-output
+
+# 2.0.2
+
+* Remove `uber` dependency as we use our own `Option::KW` now.
+* In `Contract::Build( builder: )` you now also have access to the `name:` keyword. Note that you need to double-splat in builders.
+
+        ```ruby
+        Contract::Build( builder: ->(options, constant:, **) )
+        ```
+  Same for `:method` and `Callable`.
+* `Policy::Guard( :method )` now works.
+
+# 2.0.1
+
+* Add `fail_fast: true` for `step` and `failure` to short-circuit the pipe. Note that more "eloquent" semantics are coming in `trailblazer-bpmn`.
+* Add `fail!`, `fail_fast!`, `pass!`, and `pass_fast!`. Note that they are all experimental API and not documented, yet.
+* Remove Builder and allow [dynamic `Nested`](http://trailblazer.to/gems/operation/2.0/api.html#nested-callable).
+
+    ```ruby
+    step Nested( ->(options, params:) { params[:type] == "moderated" ? Moderated : Comment } )
+    ```
+* Remove `override` in favor of `step .., override: true`. Note that this method wasn't documented.
+* Numerous internal simplifications [documented here](https://github.com/trailblazer/trailblazer-operation/blob/master/CHANGES.md#0010).
+
+
+# 2.0.0
+
+All old semantics will be available via [trailblazer-compat](https://github.com/trailblazer/trailblazer-compat).
+
+* Removed `Operation::run` as it was a bad decision. Raising an exception on invalid is a very test-specific scenario and shouldn't have been handled in the core doce.
+* Removed `Operation::present`, since you can simply call `Operation::new` (without builders) or `Operation::build_operation` (with builders).
+* Removed `Operation::valid?`. This is in the result object via `result.success?`.
+* Removed `Operation#errors`. This is in the result object via `result[:errors]` if the operation was invalid.
+* Removed the private option `:raise_on_invalid`. Use `Contract::Raise` instead, if you need it in tests.
+
+* Removed `Operation::contract` (without args). Please use `Operation::["contract.default.class"]`.
+* Removed `Operation::callbacks` (without args). Please use `Operation::["callback.<name>.class"]`.
+* Removed `Operation::contract_class`. Please use `Operation::["contract.default.class"]`.
+* Removed `Operation::contract_class=`. Please use `Operation::["contract.default.class"]=`. Doesn't inherit.
+
+## Model
+
+* The `model` method doesn't exist anymore, use `self["model"]` or write your own.
+* `:find_by` diverts to left track.
+* `:create` is `:new` now.
+
+## Builder
+
+* It's `include Builder` now, not `extend Builder`.
+* `builds` now receives one options hash.
+
+## Policy
+
+* No exception anymore, but `Operation#["policy.result"]`.
+* Access the current user via `self["current_user"]` now.
+* `Policy` is `Policy::Pundit` now as `Policy` is Trailblazer's (upcoming) authorization style.
+
+## Representer
+
+* Removed `Operation::representer_class`. Please use `Operation::["representer.class"]`.
+* Removed `Operation::representer_class=`. Please use `Operation::["representer.class"]=`.
+* You can now have any number of named representers: `Operation.representer :parser, ParsingRepresenter`.
+* Automatic infering of the representer from a `contract` is not so automatic anymore. This feature was barely used and is now available via `include Representer::InferFromContract`.
+* Reform 2.0 is not supported in `Representer` anymore, meaning you can't automatically infer representers from 2.0 contracts. Reform 2.0 works with all remaining components.
+* Removed `Operation::contract_class`. Please use `Operation::["contract.default.class"]`.
+* Removed `Operation::contract_class=`. Please use `Operation::["contract.default.class"]=`. Doesn't inherit.
+
+## Callback
+
+* Removed `Operation::Dispatch`, it's called `Operation::Callback`.
+
+
+## Collection
+
+* Removed `Operation::Collection`. Please use `Operation::present`.
+
+## Controller
+
+* Removed `Controller`, this is now in [trailblazer-rails](https://github.com/trailblazer/trailblazer-rails/).
+
+## Contract
+
+* You can't call `Create.().contract` anymore. The contract instance(s) are available through the `Result` object via `["contract.default"]`.
+* Removed the deprecation for `validate`, signature is `(params[, model, options, contract_class])`.
+* Removed the deprecation for `contract`, signature is `([model, options, contract_class])`.
+
+# 2.0.0.rc1
+
+* `consider` got removed since `step` now evaluates the step's result and deviates (or not).
+
+# 2.0.0.rc2
+
+* It's now Contract::Persist( name: "params" ) instead of ( name: "contract.params" ).
+
+# 2.0.0.beta3
+
+* New, very slick keyword arguments for steps.
+
+# 2.0.0.beta2
+
+* Removed `Operation::Controller`.
+* Renamed `Persist` to `Contract::Persist`.
+* Simplify inheritance by introducing `Operation::override`.
+* `Contract` paths are now consistent.
+
+# 2.0.0.beta1
+
+* Still undefined `self.~`.
+
+# 1.1.2
+
+* Stricter `uber` dependency.
+
 # 1.1.1
 
 * Rename `Operation::Representer::ClassMethods` to `Operation::Representer::DSL` and allow to use `DSL` and `Rendering` without `Deserialization` so you can use two different representers.

data/COMM-LICENSE

@@ -0,0 +1,62 @@
+TRAILBLAZER LICENSE AGREEMENT
+VERSION 1.1
+
+
+IMPORTANT: THIS SOFTWARE LICENSE AGREEMENT IS A LEGAL AGREEMENT (“AGREEMENT”) BETWEEN LICENSEE (“LICENSEE”) AND TRAILBLAZER GMBH. READ IT CAREFULLY BEFORE COMPLETING THE INSTALLATION PROCESS AND USING TRAILBLAZER GEMS (AT GITHUB.COM/TRAILBLAZER), TRAILBLAZER PRO AND RELATED TRAILBLAZER PRO COMPONENTS (SOURCE URL WILL BE PROVIDED AFTER PURCHASE) (“SOFTWARE”). IT PROVIDES A LICENSE TO USE THE SOFTWARE AND CONTAINS WARRANTY INFORMATION AND LIABILITY DISCLAIMERS. IN CONSIDERATION OF LICENSEE’S INSTALLATION AND USE OF THE SOFTWARE, LICENSEE HEREBY CONFIRMS THE ACCEPTANCE OF THE SOFTWARE AND AGREES TO BECOME BOUND BY THE TERMS OF THIS AGREEMENT.
+
+
+In order to use the Software under this Agreement (“Commercial Version”), Licensee must receive a source URL at the time of purchase, in accordance with the scope of use and other terms specified for each type of Software and as set forth in this Section 1 of this Agreement.
+
+1. License Grant.
+1.1 General Use. This Agreement grants Licensee a worldwide, non-exclusive, non-transferable license, valid for the license term, to use the Software, without the right to grant sublicenses, subject to the terms and conditions in this Agreement. The Software is licensed, not sold.
+1.2 Installations. Licensee may install the Software on an unlimited number of Hosts per project. “Host” means any physical or virtual machine which is controlled by Licensee. A project may involve multiple repositories.
+1.3 Applications. Licensee may distribute the Software in any applications, frameworks, or elements (collectively referred to as an “Application” or “Applications”) that Licensee develops using the Software in accordance with this Agreement, provided that such distribution does not violate the restrictions set forth in section 3 of this Agreement. Licensee must not remove, obscure or interfere with any copyright, acknowledgment, attribution, trademark, warning or disclaimer statement affixed to, incorporated in or otherwise applied in connection with the Software. Licensee is required to ensure that the Software is not reused by or with any applications other than those with which Licensee distribute it as permitted herein. For example, if Licensee installs the Software on a customer’s server, that customer is not permitted to use the Software independently of Licensee’s Application. Licensee must inform Trailblazer GmbH of any infringing use of the Software by any of Licensee’s customers. Licensee is liable for compliance by those third parties with the terms and conditions of this Agreement. Licensee shall not owe Trailblazer GmbH any royalties for Licensee’s distribution of the Software in accordance with this Agreement.
+1.4 Archive Copies. Licensee is entitled to make a reasonable amount of copies of the Software for archival purposes. Each copy must reproduce all copyright and other proprietary rights notices on or in the Software.
+1.5 Electronic Delivery. All Software and license documentation shall be delivered by electronic means unless otherwise specified on the applicable invoice (“Invoice”) or at the time of purchase. Software shall be deemed delivered when it is made available for download by Licensee (“Delivery”).
+
+2. Modifications.
+Trailblazer GmbH shall provide Licensee with source code so that Licensee can create Modifications of the Software. “Modification” means: (a) any addition to or deletion from the contents of a file included in the original Software or previous Modifications created by Licensee, or (b) any new file that contains any part of the original Software or previous Modifications. While Licensee retains all rights to any original work authored by Licensee as part of the Modifications, Trailblazer GmbH continues to own all copyright and other intellectual property rights in the Software.
+
+3. Restricted Uses.
+3.1 Licensee shall not (and shall not allow any third party to): (a) decompile, disassemble, or otherwise reverse engineer the Software or attempt to reconstruct or discover any source code, underlying ideas, algorithms, file formats or programming interfaces of the Software by any means whatsoever (except and only to the extent that applicable law prohibits or restricts reverse engineering restrictions); (b) distribute, sell, sublicense, rent, lease or use the Software for time sharing, hosting, service provider or like purposes, except as expressly permitted under this Agreement; (c) redistribute the Software or Modifications other than by including the Software or a portion thereof within Licensee’s own product, which must have substantially different functionality than the Software or Modifications and must not allow any third party to use the Software or Modifications, or any portions thereof, for software development or application development purposes; (d) redistribute the Software as part of an "appliance" or "virtual server"; (e) redistribute the Software on any server which is not directly under Licensee’s control; (f) remove any product identification, proprietary, copyright or other notices contained in the Software; (g) modify any part of the Software, create a derivative work of any part of the Software (except as permitted in Section 2), or incorporate the Software, except to the extent expressly authorized in writing by Trailblazer GmbH; (h) publicly disseminate performance information or analysis (including, without limitation, benchmarks) from any source relating to the Software; (i) utilize any equipment, device, software, or other means designed to circumvent or remove any form of Source URL or copy protection used by Trailblazer GmbH in connection with the Software, or use the Software together with any authorization code, Source URL, serial number, or other copy protection device not supplied by Trailblazer GmbH; (j) use the Software to develop a product which is competitive with any Trailblazer GmbH product offerings (unless such development is allowed by applicable law); or (k) use unauthorized Source URLS or keycode(s) or distribute or publish Source URLs or keycode(s), except as may be expressly permitted by Trailblazer GmbH in writing. If Licensee’s unique Source URL is ever published, Trailblazer GmbH reserves the right to terminate Licensee’s access without notice.
+3.2 UNDER NO CIRCUMSTANCES MAY LICENSEE USE THE SOFTWARE AS PART OF A PRODUCT OR SERVICE THAT PROVIDES SIMILAR FUNCTIONALITY AS THE SOFTWARE ITSELF.
+
+4. Ownership.
+Notwithstanding anything to the contrary contained herein, except for the limited license rights expressly provided herein, Trailblazer GmbH and its suppliers have and will retain all rights, title and interest (including, without limitation, all patent, copyright, trademark, trade secret and other intellectual property rights) in and to the Software and all copies, modifications and derivative works thereof (including any changes which incorporate any of Licensee’s ideas, feedback or suggestions). Licensee acknowledges that Licensee is obtaining only a limited license right to the Software, and that irrespective of any use of the words “purchase”, “sale” or like terms hereunder no ownership rights are being conveyed to Licensee under this Agreement or otherwise.
+
+5. Fees and Payment.
+The Software license fees will be due and payable in full as set forth in the Invoice or at the time of purchase. Licensee shall be responsible for all taxes, withholdings, duties and levies arising from the order (excluding taxes based on the net income of Trailblazer GmbH).
+
+6. Support, Maintenance and Services.
+Subject to the terms and conditions of this Agreement, as set forth in the Invoice, and as set forth on the Trailblazer PRO support page (http://pro.trailblazer.to), support and maintenance services may be included with the purchase of Licensee’s license subscription.
+
+7. Term of Agreement.
+7.1 Term. This Agreement is effective as of the Delivery of the Software and expires at such time as all license and service subscriptions hereunder have expired in accordance with their own terms (the “Term”). For clarification, the term of the license under this Agreement may be perpetual or designated as a fixed-term license in the Invoice and shall be specified at Licensee’s time of purchase. Either party may terminate this Agreement (including all related Invoices) if the other party: (a) fails to cure any material breach of this Agreement within thirty (30) days after written notice of such breach, provided that Trailblazer GmbH may terminate this Agreement immediately upon any breach of Section 3 or if Licensee exceeds any other restrictions contained in Section 1, unless otherwise specified in this agreement; (b) ceases operation without a successor; or (c) seeks protection under any bankruptcy, receivership, trust deed, creditors arrangement, composition or comparable proceeding, or if any such proceeding is instituted against such party (and not dismissed within sixty (60) days)). Termination is not an exclusive remedy and the exercise by either party of any remedy under this Agreement will be without prejudice to any other remedies it may have under this Agreement, by law, or otherwise.
+7.2 Termination. Upon any termination of this Agreement, Licensee shall cease any and all use of any Software and destroy all copies thereof.
+7.3 Expiration of License. Upon the expiration of any term under this Agreement, (a) all Software updates and services pursuant to the license shall cease, (b) Licensee may only continue to run existing installations of the Software, (c) Licensee may not install the Software on any additional Hosts, and (d) any new installation of the Software shall require the purchase of a new license subscription from Trailblazer GmbH.
+
+8. Disclaimer of Warranties.
+The Software is provided "as is", with all faults, defects and errors, and without warranty of any kind. Trailblazer GmbH does not warrant that the Software will be free of bugs, errors, viruses or other defects, and Trailblazer GmbH shall have no liability of any kind for the use of or inability to use the Software, the Software content or any associated service, and Licensee acknowledges that it is not technically practicable for Trailblazer GmbH to do so.
+To the maximum extent permitted by applicable law, Trailblazer GmbH disclaims all warranties, express, implied, arising by law or otherwise, regarding the Software, the Software content and their respective performance or suitability for Licensee’s intended use, including without limitation any implied warranty of merchantability, fitness for a particular purpose.
+
+9. Limitation of Liability.
+To the maximum extent permitted by applicable law, Trailblazer GmbH will not be liable for any direct, indirect, consequential, incidental, special, exemplary, or punitive damages or liabilities whatsoever arising from or relating to the Software, the Software content or this Agreement, whether based on contract, tort (including negligence), strict liability or other theory, even if Trailblazer GmbH has been advised of the possibility of such damages. In no event will Trailblazer GmbH's liability exceed the Software license price as indicated in the Invoice. The existence of more than one claim will not enlarge or extend this limit. Claims for damages under the Product Liability Act shall remain unaffected, as shall liability for damage to life, body or health.
+
+10. Remedies.
+Licensee’s exclusive remedy and Trailblazer GmbH’s entire liability for breach of this Agreement shall be limited, at Trailblazer GmbH’s sole and exclusive discretion, to (a) replacement of any defective software or documentation; or (b) refund of the license fee paid to Trailblazer GmbH.
+
+11. Miscellaneous
+11.1 Entire Agreement. This Agreement sets forth our entire agreement with respect to the Software and the subject matter hereof and supersedes all prior and contemporaneous understandings and agreements whether written or oral.
+11.2 No Assignment. Licensee may not assign this Agreement or any of its rights under this Agreement without the prior written consent of Trailblazer GmbH and any attempted assignment without such consent shall be void.
+11.3 Export Compliance. Licensee agrees to comply with all applicable laws and regulations, including laws, regulations, orders or other restrictions on export, re-export or redistribution of software.
+11.4 Indemnification. Licensee agrees to defend, indemnify, and hold harmless Trailblazer GmbH from and against any lawsuits, claims, losses, damages, fines and expenses (including attorneys' fees and costs) arising out of Licensee’s use of the Software or breach of this Agreement.
+11.5 Governing Law. This Agreement is governed and construed in accordance with the law of The Federal Republic of Germany and shall be subject to the exclusive jurisdiction of the Courts of Berlin, Germany. The operation of the United Nations Convention on the International Sale of Goods is hereby expressly excluded.
+11.6 Dispute Resolution. In the event of any dispute arising from or in connection with this Agreement, the parties undertake to make all their best efforts to settle the dispute amicably through negotiations, failing which either party may submit the dispute for resolution by the Courts of Berlin, Germany.
+11.7 Attorneys’ Fees and Costs. The prevailing party in any action to enforce this Agreement shall be entitled to recover its attorneys’ fees and costs in connection with such action.
+11.8 Severability. If any provision of this Agreement is held by a court of competent jurisdiction to be invalid, illegal, or unenforceable, the remainder of this Agreement shall remain in full force and effect.
+11.9 Waiver. Failure or neglect by either party to enforce at any time any of the provisions of this Agreement shall not be construed or deemed to be a waiver of that party's rights under this Agreement.
+11.10 Modifications. No modification of this Agreement shall be effective unless contained in writing and executed by an authorized representative of each party. No term or condition in Licensee’s Purchase Order or Terms and Conditions shall apply unless expressly accepted by Trailblazer GmbH.
+11.11 Force Majeure. Trailblazer GmbH shall not be liable for any delay or non-performance of its obligations under this Agreement in the event and to the extent that such delay or non-performance is due to an unforeseeable catastrophic event that prevents Trailblazer GmbH to fulfill its obligations under this Agreement and which Trailblazer GmbH cannot avoid or circumvent (“Force Majeure Event”). If the Force Majeure Event results in a delay or non-performance of Trailblazer GmbH for a period of three (3) months or longer, then Licensee shall have the right to terminate this Agreement with immediate effect without any liability (except for the obligations of payment arising prior to the event of Force Majeure).
+
+
+The Open Source version of the TRAILBLAZER GEMS (“LGPL Version”) is licensed under the terms of the GNU Lesser General Public License versions 3.0 (“LGPL”) and not under this Agreement.

data/CONTRIBUTING.md

@@ -0,0 +1,179 @@
+# Contributing to Trailblazer
+Trailblazer is an open source project and we would love you to help us make it better.
+
+## Questions/Help
+If our [guides][guides] nor [docs][api-docs] can help you figure things out, and you're stuck, refrain from posting questions on github issues, and please just find us on the [trailblazer gitter chat][chat] and drop us a line.
+
+Keep in mind when asking questions though, an example will get you help faster than anything else you do.
+
+If you file an issue with a question, it will be closed. We're not trying to be mean, don't get us wrong, we're just trying to stay sane.
+
+## Reporting Issues
+A well formatted issue is appreciated, and goes a long way in helping us help you.
+
+* Make sure you have a [GitHub account](https://github.com/signup/free)
+* Submit a [Github issue][issues-link] by:
+  * Clearly describing the issue
+    * Provide a descriptive summary
+    * Provide sample code where possible (preferably in the form of a test, in a [Gist][gist] for bonus points)
+    * Explain the expected behavior
+    * Explain the actual behavior
+    * Provide steps to reproduce the actual behavior
+    * Provide your application's complete `Gemfile.lock` as text (in a [Gist][gist] for bonus points)
+    * Any relevant stack traces
+
+If you provide code, make sure it is formatted with the triple backticks (\`).
+
+At this point, we'd love to tell you how long it will take for us to respond, but we just don't know.
+
+## Pull requests
+We accept pull requests to Trailblazer for:
+
+* Adding documentation
+* Fixing bugs
+* Adding new features
+
+Not all features proposed will be added but we are open to having a conversation about a feature you are championing.
+
+###Here's a quick guide:
+#### Fork the Project
+Fork the [project repository][project-repo-link] on Github and check out your copy.
+
+```
+git clone https://github.com/YOUR_HANDLE/trailblazer.git
+cd trailblazer
+git remote add upstream https://github.com/trailblazer/trailblazer.git
+```
+
+#### Create a Topic Branch
+Make sure your fork is up-to-date and create a topic branch for your feature or bug fix.
+```
+git checkout master
+git pull upstream master
+git checkout -b my-feature-branch
+```
+
+#### Bundle and Test
+Run bundle install/update to gather any and all dependencies. Run the tests. This is to make sure your starting point works.
+
+```
+bundle install
+bundle exec rake
+```
+
+#### Write Tests
+Try to write a test that reproduces the problem you're trying to fix or describes a feature that you want to build. Add to [test][test-link].
+
+We definitely appreciate pull requests that highlight or reproduce a problem, even without a fix.
+
+#### Write Code
+Implement your feature or bug fix.
+
+Ruby style is enforced with [RuboCop](https://github.com/bbatsov/rubocop), run `bundle exec rubocop` and fix any style issues highlighted.
+
+Make sure that `bundle exec rake` completes without errors.
+
+#### Write Documentation
+Document any external behavior in the [README](README.md).
+
+#### Commit Changes
+Make sure git knows your name and email address:
+
+```
+git config --global user.name "Your Name"
+git config --global user.email "contributor@example.com"
+```
+
+Writing good commit logs is important. A commit log should describe what has changed and why, but be brief.
+
+```
+git add your_filename.rb (File names to add content from, or fileglobs e.g. *.rb)
+git commit
+```
+
+#### Push
+```
+git push origin my-feature-branch
+```
+
+#### Make a Pull Request
+Go to https://github.com/YOUR_GH_HANDLE/trailblazer and select your feature branch. Click the 'Pull Request' button and fill out the form. Pull requests are usually reviewed within a few days, but no need to rush us if it takes longer.
+
+#### Rebase
+If you've been working on a change for a while, rebase with upstream/master.
+
+```
+git fetch upstream
+git rebase upstream/master
+git push origin my-feature-branch -f
+```
+
+#### Update CHANGELOG Again
+Update the [CHANGELOG](CHANGELOG.md) with the pull request number. A typical entry looks as follows.
+
+```
+* [#123](https://github.com/trailblazer/trailblazer/pull/123): Your brief description - [@your_gh_handle](https://github.com/your_gh_handle).
+```
+
+Amend your previous commit and force push the changes.
+
+```
+git commit --amend
+git push origin my-feature-branch -f
+```
+
+#### Check on Your Pull Request
+Go back to your pull request after a few minutes and see whether it passed muster with Travis-CI. Everything should look green, otherwise fix issues and amend your commit as described above.
+
+## Quality
+
+Committing to OSS projects is always difficult, because all maintainers will adhere to their own quality standards that you don't know. Every projects wants "good code design", and so do we, so here are a few things that you should follow when contributing.
+
+* Good design matters: sometimes a feature could be added with a simple `if <my new case>` to an existing block of code. Usually, an `if` implies that the original design didn't plan on handling multiple cases, or in other words, **a refactoring of the code structure might be necessary**. If you're unsure: [Talk to us!](https://gitter.im/trailblazer/chat)
+* Make smaller pull requests. It is so much easier to discuss something graspable and not a "37 files changed" PR. The sooner we see your code, the earlier we can decide about which way to go. It is incredibly appreciated, though, to send us a link to a branch of yours where we can see the desired changes in total. We can then help splitting those into smaller steps.
+* **Never ever use `if respond_to?`** to add a feature. This is a pattern as seen a lot in Rails core that causes incredibly hard to find ~bugs~ behavior. In Trailblazer, we use "Tell, don't ask!", which means, never try to find out the type of an object via `respond_to?`. If you really have to introspect the type, use `is_a?`. Treat it as a duck, ducks don't speak.
+
+
+## Releasing
+
+When you have release rights, please follow these rules.
+
+* When tagging a commit for a release, use the format `vX.X.X` for the tag, e.g. `git tag v2.1.0`.
+* The tagged commit **must contain the line** "Releasing vX.X.X" so it can be quickly spotted later in the commit list.
+
+#### What now?
+At this point you're waiting on us. Expect a conversation regarding your pull request; Questions, clarifications, and so on.
+
+Some things that will increase the chance that your pull request is accepted:
+* Use Trailblazer idioms and follow the Trailblazer ideology
+* Include tests that fail without your code, and pass with it
+* Update the documentation, guides, etc.
+
+## What do we need help with?
+### Helping others!
+There are a lot of questions from people as they get started using Trailblazer. If you could **please do the following things**, that would really help:
+
+- Hang out on [the chat][chat]
+- Watch the [trailblazer repositories][repositories] for issues or requests that you could help with
+
+### Contributing to community
+- Create Macros!
+- Write blog posts!
+- Record screencasts
+- Write examples.
+
+### Contributing to the core
+- Tests are always helpful!
+- Any of the issues in GitHub, let us know if you have some time to fix one.
+
+## Thank You
+Please do know that we really appreciate and value your time and work.
+
+[gist]: https://gist.github.com
+[guides]: https://www.trailblazer.to
+[api-docs]: https://www.trailblazer.to/api-docs
+[chat]: https://gitter.im/trailblazer/chat
+[repositories]: https://github.com/trailblazer
+[test-link]: https://github.com/trailblazer/trailblazer/tree/master/test
+[project-repo-link]: https://github.com/trailblazer/trailblazer
+[issues-link]: https://www.github.com/trailblazer/trailblazer/issues

data/Gemfile

@@ -2,13 +2,3 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in trailblazer.gemspec
 gemspec
-
-# gem "representable", path: "../representable"
-# gem "disposable", path: "../disposable"
-gem "virtus"
-gem "reform", github: "apotonick/reform"
-gem "roar", github: "apotonick/roar"
-# gem "reform", "~> 2.0.0"
-# gem "reform", path: "../reform"
-# gem "roar", path: "../roar"
-gem "multi_json"

data/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2018 Trailblazer GmbH
+
+Trailblazer is an Open Source project licensed under the terms of
+the LGPLv3 license.  Please see <http://www.gnu.org/licenses/lgpl-3.0.html>
+for license text.
+
+Trailblazer PRO has a commercial-friendly license allowing private forks
+and modifications of Trailblazer.  Please see http://trailblazer.to/pro for
+more detail.