Google Git
Sign in
gerrit / buck / refs/heads/github-master
commit89a0c4c70cf2b4b6c694d27649aac980be17305f[log] [tgz]
authorStiopa Koltsov <nga@fb.com>Mon Jan 20 07:15:49 2020 -0800
committerFacebook Github Bot <facebook-github-bot@users.noreply.github.com>Mon Jan 20 07:25:59 2020 -0800
tree7ffec8624682ac70293d3a74e8ff71ec740cd2e9
parent0a1f7bf4ab443386894f54194f6ceef6da572910 [diff]
project.buck_out_include_target_config_hash=true in tests

Summary:
Not in all tests yet, but in most integration tests.

Note: this diff D19353241 enabled hashed buck out in the buck repository.

These changes only affect Buck test behaviour. This change is needed to prevent regressions in hashed buck-out.

Reviewed By: gabrielrussoc

shipit-source-id: 4566c658a3366589155cff70dafc2f21d93da246
8 files changed
tree: 7ffec8624682ac70293d3a74e8ff71ec740cd2e9
  1. .buck-eden-bindmounts
  2. .buckconfig
  3. .buckjavaargs
  4. .buckrelease
  5. .editorconfig
  6. .gitattributes
  7. .gitignore
  8. .idea/
  9. .inferconfig
  10. .travis.yml
  11. BUCK
  12. CODE_OF_CONDUCT.md
  13. CONTRIBUTING.md
  14. LICENSE
  15. README.md
  16. android/
  17. appveyor.yml
  18. assets/
  19. bin/
  20. buck-parser-py.iml
  21. buck.iml
  22. build.xml
  23. config/
  24. docs/
  25. jitpack.yml
  26. pmd/
  27. programs/
  28. py/
  29. python-dsl/
  30. scripts/
  31. src-gen/
  32. src/
  33. test/
  34. third-party/
  35. tools/
  36. windows_cxx_support.txt
  37. windows_failures.txt
README.md

Buck

Buck is a build tool. To see what Buck can do for you, check out the documentation at http://buck.build/.

Build Status Build status

Installation

First, clone the Buck repository:

git clone --depth 1 https://github.com/facebook/buck.git
cd buck

Since Buck is used to build Buck, the initial build process involves 2 phases:

1. Bootstrap Buck with ant
git clone --depth 1 https://github.com/facebook/buck.git
cd buck
ant
2. Use bootstrapped version of Buck to build Buck:
./bin/buck build --show-output buck
# output will contain something like
# //programs:buck buck-out/gen/programs/buck.pex
buck-out/gen/programs/buck.pex --help
Prebuilt buck binaries

Pre-built binaries of buck for any buck sha can be downloaded from https://jitpack.io/com/github/facebook/buck/<sha>/buck-<sha>.pex. The very first time a version of buck is requested, it is built via jitpack. As a result, it could take a few minutes for this initial binary to become available. Every subsequent request will just serve the built artifact directly. This functionality is available for any fork of buck as well, so you can fetch https://jitpack.io/com/github/<github-user-or-org>/buck/<sha>/buck-<sha>.pex

Feature Deprecation

Buck tries to move fast with respect to its internals. However, for user facing features (build rules, command line interface, etc), the Buck team tries to have a graceful deprecation process. Note that this generally applies only to documented functionality, or functionality that is less documented, but appears to be in wide use. That process is:

  • An issue is opened on Github suggesting what will be deprecated, and when it will be removed. For larger features that are deprecated, there may be a period when the default is the new setting, and the old behavior may only be used with a configuration change.
  • A change is submitted to Buck that puts the old behavior behind a configuration flag and sets the default to the old behavior. These flags can be found at https://buck.build/concept/buckconfig.html#incompatible.
  • For larger features, a change eventually is put in place that sets the default to the new behavior. e.g. when Skylark becomes the default build file parser.
  • When the removal date is reached, a change is submitted to remove the feature. At this point, the configuration value will still parse, but will not be used by Buck internally.

License

Apache License 2.0