Frequently Asked Questions

I just installed Spekl but it’s not appearing on my path. Do I need to manually add it?

Spekl’s installer automatically adds the path to spm to your path. On platforms like Windows and OSX, the easiest way to refresh your path is to restart the shell you use (CMD.EXE or Cygwin, Terminal.app, etc). This should enable you to use the spm tool on the command line. On Linux platforms the path is not automatically updated and must be added to your .profile or shell init scripts. In case the automatic path modification doesn’t work (or if you are on Linux), the following list below details where Spekl is installed on various platforms:

  • Windows: C:\Program Files (x86)\spm
  • OSX: /Applications/spm
  • Linux: /opt/spm

I need to update my publishing information/authentication info, how do I do it?

All authentication information is stored under the author configuration element. See the next question (My project has multiple authors, how can we all author together?) for more information on how to get this to work.

My project has multiple authors, how can we all author together?

The author attribute in the configuration supports any number of authors. For it to work, you must first add the user to your team on GitHub. To do that, go to the team administration page for your project: https://github.com/orgs/Spekl/teams

After you add the user to your team, fill in their name and email in the author configuration element, for example:

name        : maybe-add-specs          # name of the package
version     : 0.0.1       # version of the package
kind        : spec                     # one of tool or spec(s)
description : a short description

author:
  - name: John L. Singleton
    email: jsinglet@gmail.com
  - name: Some Other User
    email: otheruser@gmail.com

When you run spm publish you will be prompted to select the user you want to use for authentication.

How Do I Update My Specs/Tools After I Publish Them?

If you still have the local directory you created the project in you can just use your normal spm publish commands.

If you are on a different machine (or you’d like to give access to someone else) just go to our Spekl page on GitHub, here: http://github.com/Spekl. Find your repo and do a normal git clone as with any other Git repository. Note however that you should not do an explicit git push – rely on spm publish do do that work for you.

Help! Something is Broken! Spekl Isn’t Working, etc

The first thing you should always do is delete the .spm directory and try installing with spm install again. If that doesn’t work, please open an issue over on our GitHub Issue Tracker.