Atom and all repositories under Atom will be archived on December 15, 2022. Learn more in our official announcement
Templates for building your Atom package and running its specs:
- Windows, macOS and Ubuntu Linux: Using GitHub Actions
- macOS and Ubuntu Linux: Using Travis CI
- Windows: Using Appveyor
- Ubuntu Linux / Docker: Using CircleCI
- Copy .github/workflows/main.yml to the same location in your package's repository tree
- 💥 Your package will now build and run its specs; you can see an example of a configured package here
- Sign up for an account on Travis CI
- Copy .travis.yml to the root of your package's repository
- Setup the Travis CI hook on your package's repository
- 💥 Your package will now build and run its specs; you can see an example of a configured package here
- Sign up for an account on Appveyor
- Add a new project
- Ensure the
Ignore appveyor.yml
setting inSettings > General
is unchecked - Copy appveyor.yml to the root of your package's repository
- 💥 Your package will now build and run its specs; you can see an example of a configured package here
- Sign up for an account on CircleCI
- Create a
.circleci
directory at the root of your project - Copy config.yml to the new directory
- Commit the changes and push them up to GitHub
- Add a new project on CircleCI
- 💥 Your package will now build and run its specs; you can see an example of a configured package here
Set the APM_TEST_PACKAGES
environment variable in your CI configuration file
to a space-separated list of packages to install before your package's tests
run.
env:
- APM_TEST_PACKAGES="autocomplete-plus some-other-package-here"
It will always download the latest available version. You can read more about the latest Atom release here.
The apm test
command assumes your package is using Jasmine
specs. You can run the specs locally using Atom's spec runner UI from the
View > Developer > Run Package Specs
menu or by pressing cmd-ctrl-alt-p
. You
can run apm help test
to learn more about that command.
The CI template uses the Atom setup Action to
install and set up Atom on a runner. The script then installs dependencies from
your package and runs the apm test
command to run your package's specs.
The CI template downloads the build-package.sh
from this repository. This script then downloads the latest Atom release,
installs your package's dependencies, and runs the apm test
command to run
your package's specs.
The appveyor.yml
template uses Chocolatey to
download and install the latest version of Atom.
apm install
is run in your package directory to ensure any node dependencies
are available. Finally, the script runs the apm test
command to run your
package's specs.