You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@buildstream.apache.org by no...@apache.org on 2020/12/29 12:37:56 UTC
[buildstream] 03/05: Add doc/source/first_project.rst
This is an automated email from the ASF dual-hosted git repository.
not-in-ldap pushed a commit to branch jjardon/getting_started
in repository https://gitbox.apache.org/repos/asf/buildstream.git
commit d3e39b0863b1b1b70e4ef473c08f0736a00205ff
Author: Javier Jardón <jj...@gnome.org>
AuthorDate: Thu Mar 15 22:25:07 2018 +0000
Add doc/source/first_project.rst
This is a minimal example of a bst project done by
Paul Sherwood
---
doc/source/first_project.rst | 80 ++++++++++++++++++++++++++++++++++++++++++++
doc/source/index.rst | 1 +
2 files changed, 81 insertions(+)
diff --git a/doc/source/first_project.rst b/doc/source/first_project.rst
new file mode 100644
index 0000000..d3c5a62
--- /dev/null
+++ b/doc/source/first_project.rst
@@ -0,0 +1,80 @@
+:orphan:
+
+.. _first_project:
+
+Your first project: HelloWorld
+==============================
+
+This is a minimal example of a BuildStream project::
+
+ $ echo "name: Hello.World" > project.conf
+ $ touch hello.world
+ $ cat hello.bst
+ kind: import
+ sources:
+ - kind: local
+ path: hello.world
+ config:
+ source: /
+ target: /
+
+ $ bst build hello.bst
+ [--:--:--][][] START Loading pipeline
+ [00:00:00][][] SUCCESS Loading pipeline
+ [--:--:--][][] START Resolving pipeline
+ [00:00:00][][] SUCCESS Resolving pipeline
+ [--:--:--][][] START Resolving cached state
+ [00:00:00][][] SUCCESS Resolving cached state
+
+ BuildStream Version 1.1.2.dev4+g7fdddf3
+ Session Start: Thursday, 08-03-2018 at 16:53:34
+ Project: Hello.World (/src)
+ Targets: hello.bst
+
+ User Configuration
+ Configuration File: Default Configuration
+ Log Files: /root/.cache/buildstream/logs
+ Source Mirrors: /root/.cache/buildstream/sources
+ Build Area: /root/.cache/buildstream/build
+ Artifact Cache: /root/.cache/buildstream/artifacts
+ Maximum Fetch Tasks: 10
+ Maximum Build Tasks: 4
+ Maximum Push Tasks: 4
+ Maximum Network Retries: 2
+
+ Pipeline
+ buildable b4f6a94f hello.bst
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ [--:--:--][][] START Checking sources
+ [00:00:00][][] SUCCESS Checking sources
+ [--:--:--][][] START Starting build
+ [--:--:--][b4f6a94f][build:hello.bst ] START root/.cache/buildstream/logs/Hello.World/hello/b4f6a94f-build.607.log
+ [--:--:--][b4f6a94f][build:hello.bst ] START Staging sources
+ [00:00:00][b4f6a94f][build:hello.bst ] SUCCESS Staging sources
+ [--:--:--][b4f6a94f][build:hello.bst ] START Caching Artifact
+ [00:00:00][b4f6a94f][build:hello.bst ] SUCCESS Caching Artifact
+ [00:00:00][b4f6a94f][build:hello.bst ] SUCCESS root/.cache/buildstream/logs/Hello.World/hello/b4f6a94f-build.607.log
+ [00:00:00][][] SUCCESS Build Complete
+
+ Pipeline Summary
+ Total: 1
+ Session: 1
+ Fetch Queue: processed 0, skipped 1, failed 0
+ Build Queue: processed 1, skipped 0, failed 0
+
+ $ bst checkout hello.bst my-output
+ [--:--:--][][] START Loading pipeline
+ [00:00:00][][] SUCCESS Loading pipeline
+ [--:--:--][][] START Resolving pipeline
+ [00:00:00][][] SUCCESS Resolving pipeline
+ [--:--:--][][] START Resolving cached state
+ [00:00:00][][] SUCCESS Resolving cached state
+ [--:--:--][][] START Staging dependencies
+ [00:00:00][][] SUCCESS Staging dependencies
+ [--:--:--][][] START Integrating sandbox
+ [00:00:00][][] SUCCESS Integrating sandbox
+ [--:--:--][][] START Checking out files in my-output
+ [00:00:00][][] SUCCESS Checking out files in my-output
+
+ $ ls my-output/
+ hello.world
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 6985ec1..d01c325 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -24,6 +24,7 @@ dependencies.
main_quickstart
install
docker
+ first_project
.. toctree::