opensource.google.com

Menu

Docs

Get the Code Working with Google

The setup requirements for Google’s tools are often different than the setup requirements of the imported code. All Google engineers should be able to use the imported code just by running the build tool.

General language guidance

Many languages have special subdirectories where the code resides. These include:

Dart:        //third_party/dart
.NET:        //third_party/dotnet and //third_party/dotnet_src
Emacs Lisp:  //third_party/elisp
Go:          //third_party/golang
Haskell:     //third_party/haskell
Java:        //third_party/java and //third_party/java_src
JavaScript:  //third_party/javascript
Lua:         //third_party/lua
Common Lisp: //third_party/lisp
Objective C: //third_party/objective_c
PHP:         //third_party/php
Puppet:      //third_party/puppet
Python:      //third_party/py
R:           //third_party/R
Ruby:        //third_party/ruby
Swift:       //third_party/swift

Mixed language code can go into //third_party without needing to be in a subdirectory.

Package naming

Typically, the package name is based on the repository name from whatever site you retrieved the code. But Blaze doesn’t support the use of hyphens or periods in names, so replace those with underscores.

Language-specific guidance

Some languages use specific strategies to make your job easier and your code more reusable.

Unsupported languages

Some languages aren’t officially supported at Google. Support for them is typically ad-hoc, but they are still required to follow third-party guidelines. For example: not including binary objects in language-specific subdirectories and adhering to the One Version Policy.

Unsupported languages may have their own additional third-party policies, though we are in the process of removing these, and unifying all unsupported languages under the default policy.

IMPORTANT: Do not add dependencies to any projects using unsupported languages in your production code.

NEXT: Document the code and its context

Except as otherwise noted, the content of this page is licensed under CC-BY-4.0 license. Third-party product names and logos may be the trademarks of their respective owners.