Defines an ArtifactSource abstraction for source code.
A Scala library exposing the core ArtifactSource abstraction, representing a set of artifacts (probably source code) that may be read from or written to a range of sources, including the file system, a zip file, a local Git repository, or GitHub.
This library is used by most Atomist Java and Scala projects.
An ArtifactSource is typically constructed in one of two ways:
- To front a directory-oriented abstraction such as a file system. In this case, directories will front their counterparts in the other representation.
- Through adding files containing path information. In this case, directories will be inferred.
Files and directories can be given directory paths. Paths begin
without any special character, and use / as a delimiter, e.g.,
src/main/java.
Most users will not need to use this project directly, but will use tools, e.g., rug-cli, that build on this project.
If you wish to develop tools using this project, you will need to add
this project as a dependency and the maven repository where it is
published to your build tool's configuration. For example, if you use
maven, add the dependency to the <dependencies> section and the
repository to the <repositories> section of your pom.xml:
<?xml version='1.0' encoding='UTF-8'?>
<project
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0">
<modelVersion>4.0.0</modelVersion>
...
<dependencies>
...
<dependency>
<groupId>com.atomist</groupId>
<artifactId>artifact-source</artifactId>
<version>0.5.0</version>
</dependency>
...
</dependencies>
...
<repositories>
<repository>
<id>public-atomist-release</id>
<name>Atomist Release</name>
<url>https://atomist.jfrog.io/atomist/libs-release</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
...
</project>Be sure to change the <version> to the one you want to use.
General support questions should be discussed in the #support
channel on our community slack team
at atomist-community.slack.com.
If you find a problem, please create an issue.
You can build, test, and install the project locally with maven.
$ mvn installTo create a new release of the project, simply push a tag of the form
M.N.P where M, N, and P are integers that form the next
appropriate semantic version for release. For example:
$ git tag -a 1.2.3The Travis CI build (see badge at the top of this page) will automatically create a GitHub release using the tag name for the release and the comment provided on the annotated tag as the contents of the release notes. It will also automatically upload the needed artifacts.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent