| Commit message (Collapse) | Author | Age | Files | Lines |
|---|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
o doc/Makefile: Added new directory to collect rst files from
o doc/examples/first-project: Added the "first-project" example
project.
o doc/source/sessions/first-project-*.html: Added the generated
snippets
o doc/source/using_tutorial.rst: Added the new main tutorial page
o doc/source/tutorial/first-project.rst: Added part 1 of the tutorial here
o tests/examples/first-project.py: Added test for the example project
This is largely based on an example by Javier Jardón, which was
submitted at https://gitlab.com/BuildStream/buildstream/merge_requests/323
Fixes #103
|
| |
|
|
|
|
|
|
|
|
|
| |
If --force is not specified, then we'll skip session files in
the case that all of the outputs exist.
Now setting BST_FORCE_SESSION_REBUILD when building the docs
will cause the session files to be rebuilt regardless of whether
they exist or not.
The .gitlab-ci.yml was also changed to use this and force rebuilds.
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
When specifying a fake-output string, we don't really run the command
or assume it was a `bst` command, and we pretend that `fake-output`
was the output of the command.
Specifying an empty string explicitly enables the behavior too
for faking a command that has no stdout/stderr.
This also adds the "remove-files" hack allowing the session scripts
to remove files before executing commands (kind of unsure if we're
gonna keep this...)
|
| |
|
|
| |
This list needs to not be quoted.
|
| |
|
|
|
|
|
|
|
|
| |
Before we were creating one description file for each output,
making it easier to declare a make rule for it - but the result
was that we would have to build things more and it takes a
long time.
Instead, now we have session files which describe a series of commands
to run in a session, and each command optionally produces an output file.
|
| |
|
|
|
|
|
|
|
| |
This method doesn't really do anything as this is already the default
behavior of `docker volume create` so remove it and always call
`docker volume create` directly. This command will always print the name
of the volume on STDOUT which is not very interesting so silence that.
(If it errors out for some reason, that output will go to STDERR so the
user should still be able to see that.)
|
| |
|
|
|
| |
As we can only accept arguments when a command is specified, make it
clear in the usage instructions.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
o Giving main pages simple word titles
This makes the main page:
* About
* Installing
* Using
* Reference
* Contributing
o Now named all rst files with their parent page name as a prefix.
o Also changed some titles to make overall consistent titles.
|
| |
|
|
|
|
| |
This was a bad idea and doesnt play well with mobile UIs, better
off to just include the whole thing even if it's long, and let
the backing page handle vertical scrolling.
|
| |
|
|
|
| |
Use the gitlab cache for caching sources needed for building projects
in order to collect sample output for documentation pages.
|
| |
|
|
| |
And some instructions about generating `bst` output for documentation
|
| |
|
|
|
|
|
| |
This is only to make it easier for people who just want to
build docs locally and not regenerate the session files.
The session snapshot html files are always generated in CI every time.
|
| |
|
|
| |
subdirectory
|
| |
|
|
| |
Show the commands at work in this example.
|
| |
|
|
|
| |
The Makefile uses these to run some scenarios which are
later included by the documentation directly.
|
| |
|
|
|
|
| |
If you need an example output of bst to put in the documentation,
just add a .run file to the doc/examples directory and it will result
in a similarly named .html file in doc/source/examples.
|
| |
|
|
|
|
|
| |
This baby runs bst and captures the output with colors enabled
and then generates some html we can include in documentation.
These can be generated in CI continuously and used in the documentation.
|
| |
|
|
| |
Fixes issue #380
|
| | |
|
| |
|
|
|
|
| |
Seems that the "commands" is taking a lot of space such that
we can't see the other sections here easily, that is alright
if "commands" remains at the end.
|
| |
|
|
|
| |
Here we're really listing examples, a ToC with depth is
not great here.
|
| |
|
|
| |
project on gitlab.
|
| |
|
|
| |
This was named autotools-flatpak, changed to flatpak-autotools.
|
| |
|
|
|
| |
We still have a few unused artifacts in the docs generation,
this is just one less.
|
| |
|
|
|
|
| |
This branch fixes #312 by using a hidden toctree to include
the buildstream package and reducing the amount of allowed :orphan:
pages.
|
| | |
|
| | |
|
| |
|
|
|
| |
This is nice to have on the main page, and is only a few links, dont
like having a whole toplevel ToC entry for this.
|
| | |
|
| |
|
|
|
| |
Sphinx generates some library style module index, we just include
it in a hidden toctree and avoid using it altogether.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
o Now the page titles are declared in plugins, allowing for
a more descriptive ToC
o Makefile and plugin.rsttemplate updated to not produce the title,
to no longer use `:orphan:` for plugin pages, and to ignore any
private modules in the plugin directories.
o Interestingly, now the docs will fail to build if you add
a new plugin and forget to add it to the documentation.
|
| |
|
|
|
| |
The main page has too much information on it otherwise, we want
a friendly, not overwhelming first page to our docs.
|
| |
|
|
|
|
|
| |
--track-cross-junctions now concerns crossing junctions rather than
forbidding elements in sub-project to be tracked.
Part of #359.
|
| |
|
|
|
|
|
|
|
|
|
| |
Workspaces are now index by colon separated junction path. This
now allows to create workspaces for elements in external projects.
Workspaces are owned by context instead of root project. However
it is initialized once top-level project is registered as we need
to resolve paths relatively to this top-level project.
Part of #359.
|
| |
|
|
|
| |
Make it clear we expect the top-level project here as we use it to
resolve paths relative to project directory.
|
| |
|
|
|
|
| |
'a.bst:b.bst' gets interpreted as 'b.bst' from junction 'a.bst'.
Part of #359.
|
| |
|
|
| |
This closes #256
|
| |
|
|
|
|
|
| |
oversized artifacts
This user facing string was redundantly declared in two places, only
the message when catching the error was ever printed.
|
| | |
|
| | |
|
| | |
|
| |
|
|
|
|
|
|
| |
The tests include a new environment variable: BST_CACHE_QUOTA.
This variable is used in receive_main() in pushreceive.py.
Test names: test_artifact_expires, test_large_artifact_is_not_cached_remotely
test_recently_pulled_artifact_does_not_expire: marked as xfail until
we implement LRU expiry in remote share
|
| |
|
|
|
|
| |
New file consisting of functions that allow us to generate elements
on the fly
__init__.py now includes create_element_size()
|
| |
|
|
| |
This fixes #136
|
| | |
|
| |
|
|
|
| |
The unused list_remote_refs() function has also been removed as
part of this commit.
|
| | |
|
| | |
|
| |
|
|
|
|
| |
o This supports deeply nested commands as well as shallow commands
o Automated support for bash completions included
|
| | |
|
