Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
S
sbws
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container Registry
Model registry
Operate
Environments
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
juga
sbws
Commits
390aa1cb
Commit
390aa1cb
authored
6 years ago
by
juga
Browse files
Options
Downloads
Patches
Plain Diff
Replace public changes by the version
that will be considered production ready
parent
2aa8266f
No related branches found
Branches containing commit
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+2
-35
2 additions, 35 deletions
README.md
with
2 additions
and
35 deletions
README.md
+
2
−
35
View file @
390aa1cb
...
...
@@ -16,6 +16,8 @@ used by Tor and would only create more traffic in the Tor network.
See ./INSTALL.rst) for install instructions,
[
./DEPLOY.rst
](
./DEPLOY.rst
)
for deploy instructions,
[./CONTRIBUTING](./CONTRIBUTING.rst) for contribution guidelines.
=======
`sbws`
will be considered production ready when version 1.0.0 will be releases.
More extensive documentation can be found in the ./docs directory,
also online at https://sbws.readthedocs.io and
...
...
@@ -38,41 +40,6 @@ also online at https://sbws.readthedocs.io and
-
`tests/integration/`
more complex tests and/or tests that require Tor to be running
-
`tests/testnets/`
scripts and code for running mini Tor networks locally
### The public API for sbws
As required by semantic versioning, the public API for sbws will not change
without a major version bump. The public API is
-
**The available configuration options and their defaults**
. New options may
be added without a major version bump, but no options will be removed, nor
will defaults be drastically changed. Examples of drastic changes to defaults
include obvious things like changing the default URL for the file to download
or a location for data storage, but also more subjective things, such as
increasing the target download time significantly (6s to 60s). Examples of an
insignificant change include changing the default client nickname. Rule of
thumb: if it is likely to affect results or sbws behavior significantly, it is
a major change.
-
**The name and function of commands**
. The command you run to perform certain
actions will not change in a backward incompatible way without a major
version change. For example to generate a v3bw file you will always run
`sbws
generate`
unless there is a major version bump and the release notes indicate
the command has changed.
-
**The format of output**
. Results (stored in
`~/.sbws/datadir`
by default)
will not change their format in a backward incompatible way without both a
major version bump and a bump in the result version integer. The v3bw file
generated with
`sbws generate`
will not change its format without a major
version bump.
*
Log lines and the output of
`sbws stats`
are exceptions to this
rule
*
.
-
**NOT the name, location, signature, or existance of python functions**
. Sbws
is meant to be ran as a standalone program. It is not at all meant to be
treated or used like a library. Users of sbws do
*not*
need an understanding of
how its code is laid out. Therefore the code may change drastically without a
major version bump as long as the way users interact with it does not change in
a backward incompatible way.
## The `.sbws` directory
By default is
`~/.sbws`
.
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment