PowerShell/README.md
Andrew Schwartzmeyer 841f76ec37 Update Git setup documentation
Now that everyone needs all the submodules. Much simpler.
2016-04-12 16:16:17 -07:00

3.5 KiB

PowerShell

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 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

Build Status

Platform master
Ubuntu 14.04 Build Status
Windows Build status

Get PowerShell

Linux Windows .NET Core Windows .NET Full OS X PSRP
Build from Source Instructions Instructions Instructions Instructions Instructions
Get Binaries Releases Artifacts Artifacts Releases TBD

Building summary: Start-PSBuild from the module ./PowerShellGitHubDev.psm1 (self-host on Linux / OS X)

See Linux releases and Windows artifacts installation instructions.

Team coordination

If you encounter any problems, see the known issues, search the issues, and if all else fails, open a new issue.

Obtain the source code

Setup Git

Install Git, the version control system.

See the Contributing Guidelines for more Git information, such as our installation instructions, contributing rules, and Git best practices.

Download source code

Clone this repository. It is a "superproject" and has a number of other repositories embedded within it as submodules. Please see the contributing guidelines and learn about submodules. To make things easy, we can just clone recursively.

git clone --recursive https://github.com/PowerShell/PowerShell.git

You can verify that the submodules were initialized properly with:

git submodule status

If they're initialized, it will look like this:

 f23641488f8d7bf8630ca3496e61562aa3a64009 src/Modules/Pester (f23641488)
 c99458533a9b4c743ed51537e25989ea55944908 src/libpsl-native/test/googletest (release-1.7.0)
 e6bf85694ae8352d77175c4c7d304946e018808c src/windows-build (monad/cc6afbeb-3/31)

If they're not, there will be minuses in front (and the folders will be empty):

-f23641488f8d7bf8630ca3496e61562aa3a64009 src/Modules/Pester (f23641488)
-c99458533a9b4c743ed51537e25989ea55944908 src/libpsl-native/test/googletest (release-1.7.0)
-e6bf85694ae8352d77175c4c7d304946e018808c src/windows-build (monad/cc6afbeb-3/31)