https://github.com/JuliaLang/julia
Tip revision: 1c57c68ad09740363126bbb7cb7cac557a63dc3a authored by Valentin Churavy on 02 May 2019, 16:19:33 UTC
fixup! apply NVPTX shmem patches
fixup! apply NVPTX shmem patches
Tip revision: 1c57c68
README.md
<a name="logo"/>
<div align="center">
<a href="https://julialang.org/" target="_blank">
<img src="https://julialang.org/images/logo_hires.png" alt="Julia Logo" width="210" height="142"></img>
</a>
</div>
Build status:
[![travis][travis-img]](https://travis-ci.org/JuliaLang/julia)
[![appveyor][appveyor-img]](https://ci.appveyor.com/project/JuliaLang/julia/branch/master)
Code coverage:
[![coveralls][coveralls-img]](https://coveralls.io/r/JuliaLang/julia?branch=master)
[![codecov][codecov-img]](https://codecov.io/github/JuliaLang/julia?branch=master)
[travis-img]: https://img.shields.io/travis/JuliaLang/julia/master.svg?label=Linux+/+macOS
[appveyor-img]: https://img.shields.io/appveyor/ci/JuliaLang/julia/master.svg?label=Windows
[coveralls-img]: https://img.shields.io/coveralls/github/JuliaLang/julia/master.svg?label=coveralls
[codecov-img]: https://img.shields.io/codecov/c/github/JuliaLang/julia/master.svg?label=codecov
## The Julia Language
Julia is a high-level, high-performance dynamic language for technical
computing. The main homepage for Julia can be found at
[julialang.org](https://julialang.org/). This is the GitHub
repository of Julia source code, including instructions for compiling
and installing Julia, below.
## Resources
- **Homepage:** <https://julialang.org>
- **Binaries:** <https://julialang.org/downloads/>
- **Source code:** <https://github.com/JuliaLang/julia>
- **Documentation:** <https://docs.julialang.org/>
- **Packages:** <https://pkg.julialang.org/>
- **Discussion forum:** <https://discourse.julialang.org>
- **Slack:** <https://julialang.slack.com> (get an invite from <https://slackinvite.julialang.org>)
- **YouTube:** <https://www.youtube.com/user/JuliaLanguage>
- **Code coverage:** <https://coveralls.io/r/JuliaLang/julia>
New developers may find the notes in
[CONTRIBUTING](https://github.com/JuliaLang/julia/blob/master/CONTRIBUTING.md)
helpful to start contributing to the Julia codebase.
### External Resources
- [**StackOverflow**](https://stackoverflow.com/questions/tagged/julia-lang)
- [**Twitter**](https://twitter.com/JuliaLanguage)
- [**Meetup**](https://julia.meetup.com/)
## Currently Supported Platforms
| Operating System | Architecture | CI | Binaries | Support Level |
|:----------------:|:----------------:|:--:|:--------:|:-------------:|
| macOS 10.8+ | x86-64 (64-bit) | ✓ | ✓ | Tier 1 |
| Windows 7+ | x86-64 (64-bit) | ✓ | ✓ | Tier 1 |
| | i686 (32-bit) | ✓ | ✓ | Tier 1 |
| FreeBSD 11.0+ | x86-64 (64-bit) | [✓](https://build.julialang.org/#/builders/68) | ✓ | Tier 1 |
| Linux 2.6.18+ | x86-64 (64-bit) | ✓ | ✓ | Tier 1 |
| | i686 (32-bit) | ✓ | ✓ | Tier 1 |
| | ARM v7 (32-bit) | | | Tier 3 |
| | ARM v8 (64-bit) | | | Tier 3 |
| | x86-64 musl libc | | | Tier 3 |
| | PowerPC (64-bit) | | | Tier 4 |
| | PTX (64-bit) | [✓](https://gitlab.com/JuliaGPU/CUDAnative.jl/pipelines) | | [External](https://github.com/JuliaGPU/CUDAnative.jl) |
All systems marked with ✓ for CI are tested using continuous integration for every commit.
Systems with ✓ for binaries have official binaries available on the
[downloads](https://julialang.org/downloads) page and are tested regularly.
The PTX backend is supported by the [JuliaGPU](https://github.com/JuliaGPU) organization and
requires the [CUDAnative.jl](https://github.com/JuliaGPU/CUDAnative.jl) package.
### Support Tiers
* Tier 1: Julia is guaranteed to build from source and pass all tests on these platforms
when built with default options. Official binaries are available for releases and CI is
run on every commit.
* Tier 2: Julia is guaranteed to build from source using default build options, but may
or may not pass all tests. Official binaries are available on a case-by-case basis.
* Tier 3: Julia may or may not build. If it does, it is unlikely to pass tests.
* Tier 4: Julia is known not to build.
It is possible that Julia will build and work on other platforms too,
and we're always looking to improve our platform coverage. If you're
using Julia on a platform not listed here, let us know!
## Building Julia
First, make sure you have all the [required
dependencies](https://github.com/JuliaLang/julia/blob/master/doc/build/build.md#required-build-tools-and-external-libraries) installed.
Then, acquire the source code by cloning the git repository:
git clone git://github.com/JuliaLang/julia.git
By default you will be building the latest unstable version of
Julia. However, most users should use the most recent stable version
of Julia. You can get this version by changing to the Julia directory
and running:
git checkout v1.1.0
Now run `make` to build the `julia` executable.
Building Julia requires 2GiB of disk space and approximately 4GiB of virtual memory.
**Note:** The build process will fail badly if any of the build directory's parent directories have spaces or other shell meta-characters such as `$` or `:` in their names (this is due to a limitation in GNU make).
Once it is built, you can run the `julia` executable after you enter your julia directory and run
./julia
Your first test of Julia determines whether your build is working
properly. From the UNIX/Windows command prompt inside the `julia`
source directory, type `make testall`. You should see output that
lists a series of running tests; if they complete without error, you
should be in good shape to start using Julia.
You can read about [getting
started](https://docs.julialang.org/en/stable/manual/getting-started/)
in the manual.
In case this default build path did not work, detailed build instructions
are included in the [build documentation](https://github.com/JuliaLang/julia/blob/master/doc/build).
### Uninstalling Julia
Julia does not install anything outside the directory it was cloned
into. Julia can be completely uninstalled by deleting this
directory. Julia packages are installed in `~/.julia` by default, and
can be uninstalled by deleting `~/.julia`.
## Binary Installation
If you would rather not compile the latest Julia from source,
platform-specific tarballs with pre-compiled binaries are also
[available for download](https://julialang.org/downloads/).
If everything works correctly, you will see a Julia banner and an
interactive prompt into which you can enter expressions for
evaluation. You can read about [getting
started](https://julialang.org/manual/getting-started) in the manual.
**Note**: Although some system package managers provide Julia, such
installations are neither maintained nor endorsed by the Julia
project. They may be outdated and/or unmaintained. We recommend you
use the official Julia binaries instead.
## Source Code Organization
The Julia source code is organized as follows:
base/ source code for the Base module (part of Julia's standard library)
stdlib/ source code for other standard library packages
contrib/ editor support for Julia source, miscellaneous scripts
deps/ external dependencies
doc/src/manual source for the user manual
doc/build detailed notes for building Julia
src/ source for Julia language core
test/ test suites
ui/ source for various front ends
usr/ binaries and shared libraries loaded by Julia's standard libraries
## Terminal, Editors and IDEs
The Julia REPL is quite powerful. See the section in the manual on
[the Julia REPL](https://docs.julialang.org/en/latest/stdlib/REPL/)
for more details.
Support for editing Julia is available for many
[widely used editors](https://github.com/JuliaEditorSupport):
[Emacs](https://github.com/JuliaEditorSupport/julia-emacs),
[Vim](https://github.com/JuliaEditorSupport/julia-vim),
[Sublime Text](https://github.com/JuliaEditorSupport/Julia-sublime), and many
others.
Supported IDEs include: [Juno](http://junolab.org/) (Atom plugin),
[julia-vscode](https://github.com/JuliaEditorSupport/julia-vscode) (VS
Code plugin), and
[julia-intellij](https://github.com/JuliaEditorSupport/julia-intellij)
(IntelliJ IDEA plugin). The popular [Jupyter](https://jupyter.org/)
notebook interface is available through
[IJulia](https://github.com/JuliaLang/IJulia.jl).