how-to-use-as-dependency-in-pharo.md

How to use Superluminal as dependency in a Pharo product

In order to include Superluminal as part of your project, you should reference the package in your product baseline:

1. Define the Superluminal repository and version to be used, and the baseline groups you want to depend on (usually Deployment).

   If you're unsure about what to depend on use the Dependency Analyzer tool to choose an appropriate group including the packages you need.

2. Create a method like this one in the baseline class of your product:

   setUpDependencies: spec
   
     spec
       baseline: 'Superluminal'
       with: [ spec repository: 'github://github://ba-st/Superluminal:v{XX}' ];
       project: 'Superluminal-Deployment'
       copyFrom: 'Superluminal' with: [ spec loads: 'Deployment' ]

   This will create Superluminal-Deployment as a valid target that can be used as requirement in your own packages.

   Replace {XX} with the version you want to depend on

3. Use the new loading target as a requirement on your packages. For example:

   baseline: spec
   
   <baseline>
   spec
     for: #pharo
     do: [
       self setUpDependencies: spec.
       spec
         package: 'My-Package'
         with: [ spec requires: #('Superluminal-Deployment') ] ]