2016-03-30 21:06:57 +02:00
|
|
|
PowerShell
|
|
|
|
==========
|
2015-07-02 00:06:29 +02:00
|
|
|
|
2016-03-31 00:13:29 +02:00
|
|
|
This repository is "Project Magrathea": Open PowerShell on GitHub, for
|
|
|
|
Linux, Windows (.NET Core and Full), and OS X. It is built using the
|
|
|
|
[.NET Command Line Interface][dotnet-cli] to support targetting every
|
|
|
|
flavor of PowerShell. It is a collaborative effort among many teams:
|
|
|
|
|
|
|
|
- Full PowerShell
|
|
|
|
- Core PowerShell
|
|
|
|
- Open Source Technology Center
|
|
|
|
- .NET Foundation
|
|
|
|
|
|
|
|
[dotnet-cli]: https://github.com/dotnet/cli
|
|
|
|
|
2016-03-30 21:06:57 +02:00
|
|
|
Build Status
|
|
|
|
------------
|
2016-01-22 20:36:23 +01:00
|
|
|
|
2016-03-30 21:06:57 +02:00
|
|
|
| Platform | `master` |
|
|
|
|
|--------------|----------|
|
|
|
|
| Ubuntu 14.04 | [![Build Status](https://travis-ci.com/PowerShell/PowerShell.svg?token=31YifM4jfyVpBmEGitCm&branch=master)](https://travis-ci.com/PowerShell/PowerShell) |
|
|
|
|
| Windows | [![Build status](https://ci.appveyor.com/api/projects/status/wb0a0apbn4aiccp1/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/powershell-linux/branch/master) |
|
|
|
|
|
2016-03-31 00:13:29 +02:00
|
|
|
Get PowerShell
|
|
|
|
--------------
|
|
|
|
|
2016-03-31 00:57:52 +02:00
|
|
|
| | Linux | Windows .NET Core | Windows .NET Full | OS X | PSRP |
|
|
|
|
|-----------------------|-------|-------------------|-------------------|------|------|
|
|
|
|
| Build from **Source** | [Instructions](docs/building/linux.md) | [Instructions](docs/building/windows-core.md) | [Instructions](docs/building/windows-full.md) | [Instructions](docs/building/osx.md) | [Instructions](docs/building/psrp.md) |
|
|
|
|
| Get **Binaries** | [Releases][] | [Artifacts][] | [Artifacts][] | [Releases][] | TBD |
|
2016-03-31 00:13:29 +02:00
|
|
|
|
|
|
|
Building summary: `Start-PSBuild` from the module
|
|
|
|
`./PowerShellGitHubDev.psm1` (self-host on Linux / OS X)
|
|
|
|
|
2016-03-31 08:29:16 +02:00
|
|
|
See [Linux releases](docs/installation/linux.md) and
|
|
|
|
[Windows artifacts](docs/installation/windows.md) installation
|
|
|
|
instructions.
|
|
|
|
|
2016-03-31 00:13:29 +02:00
|
|
|
[releases]: https://github.com/PowerShell/PowerShell/releases
|
|
|
|
[artifacts]: https://ci.appveyor.com/project/PowerShell/powershell-linux/build/artifacts
|
|
|
|
|
2016-03-30 21:06:57 +02:00
|
|
|
Team coordination
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
- [PSCore Slack chat](https://pscore.slack.com/)
|
|
|
|
- [Waffle.io scrum board](https://waffle.io/PowerShell/PowerShell)
|
2016-01-22 20:36:23 +01:00
|
|
|
|
2016-03-31 00:13:29 +02:00
|
|
|
If you encounter any problems, see the [known issues](KNOWNISSUES.md),
|
|
|
|
search the [issues][], and if all else fails, open a new issue.
|
|
|
|
|
|
|
|
[issues]: https://github.com/PowerShell/PowerShell/issues
|
|
|
|
|
2016-03-31 08:29:16 +02:00
|
|
|
Obtain the source code
|
|
|
|
----------------------
|
2015-07-02 00:06:29 +02:00
|
|
|
|
2015-10-08 22:44:37 +02:00
|
|
|
### Setup Git
|
2015-07-02 00:06:29 +02:00
|
|
|
|
2016-01-21 21:25:48 +01:00
|
|
|
Install [Git][], the version control system.
|
|
|
|
|
2016-03-14 20:03:04 +01:00
|
|
|
See the [Contributing Guidelines](CONTRIBUTING.md) for more Git
|
|
|
|
information, such as our installation instructions, contributing
|
|
|
|
rules, and Git best practices.
|
2016-03-09 23:24:15 +01:00
|
|
|
|
2016-03-14 20:03:04 +01:00
|
|
|
[Git]: https://git-scm.com/documentation
|
2016-03-09 23:24:15 +01:00
|
|
|
|
2016-03-14 20:03:04 +01:00
|
|
|
### Download source code
|
2016-01-21 21:25:48 +01:00
|
|
|
|
2016-03-14 20:03:04 +01:00
|
|
|
Clone this repository. It is a "superproject" and has a number of
|
|
|
|
other repositories embedded within it as submodules. *Please* see the
|
2016-03-31 00:13:29 +02:00
|
|
|
contributing guidelines and learn about submodules. Not every
|
|
|
|
submodule is required on every system; see the individual build
|
|
|
|
instructions for the necessary subsets.
|