semantic-rs alternatives and similar packages
Based on the "Development tools" category.
Alternatively, view semantic-rs alternatives based on common mentions on social networks and blogs.
-
rust-analyzer
A Rust compiler front-end for IDEs [Moved to: https://github.com/rust-lang/rust-analyzer] -
Clippy
A bunch of lints to catch common mistakes and improve your Rust code. Book: https://doc.rust-lang.org/clippy/ -
gdbgui
Browser-based frontend to gdb (gnu debugger). Add breakpoints, view the stack, visualize data structures, and more in C, C++, Go, Rust, and Fortran. Run gdbgui from the terminal and a new tab will open in your browser. -
Rust Language Server
Repository for the Rust Language Server (aka RLS) -
rust-cross
Everything you need to know about cross compiling Rust programs! -
quickcheck
Automated property based testing for Rust (with shrinking). -
trust
Travis CI and AppVeyor template to test your Rust crate on 5 architectures and publish binary releases of it for Linux, macOS and Windows -
cargo-release
Cargo subcommand `release`: everything about releasing a rust crate. -
Rust for Visual Studio Code
Rust for Visual Studio Code -
sublime-rust
The official Sublime Text 3 package for the Rust Programming Language -
cargo-update
A cargo subcommand for checking and applying updates to installed executables -
milksnake
A setuptools/wheel/cffi extension to embed a binary data in wheels -
cargo-deb
A cargo subcommand that generates Debian packages from information in Cargo.toml -
rst
The open source design documentation tool for everybody [Moved to: https://github.com/vitiral/artifact] -
cargo-modules
Render your crate's module/item structure as a tree or graph -
rust-musl-cross
Docker images for compiling static Rust binaries using musl-cross
Static code analysis for 29 languages.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of semantic-rs or a related project?
README
semantic-rs
The purpose of this tool is to help people to publish crates following the semver specification.
Right now if you're building a new crate publishing new versions includes a high amount of work. You need to decide if the new version will be either a new Major, Minor or Patch version. If that decision is made, the next step is to write a changelog with all the things changed. Then increase the version in Cargo.toml
. Make a commit and a new tag for the new version and lastly publish it to crates.io.
If you need to repeat these steps every time, chances are high you make mistakes.
semantic-rs automates all these steps for you so you can focus more on developing new features instead.
Workflow
- Install semantic-rs on your machine.
- Follow the Angular.js commit message conventions when you commit changes to your repository
- When you're done with development, run semantic-rs
- Based on your changes it determines the next version number, generates a changelog, commits it and creates a new tag
- It also increases the version number in
Cargo.toml
(also committed) - Runs
cargo package
for you - Creates a release on GitHub
- Publishes the new version to crates.io
- Done ๐
Usage
Installation via crates.io
Ubuntu:
$ sudo apt-get install -y cmake libssl-dev pkg-config zlib1g-dev
$ cargo install semantic-rs
Prerequisites
You need the following data beforehand:
- A GitHub application token Get it here
- Your crates.io API key Get it here
Run it
semantic-rs depends on some data being passed in via environment variables. In our examples we specify those variables explicitly but if you run semantic-rs frequently you may want to configure those in your shell's configuration file.
Setting GIT_COMITTER_NAME
and GIT_COMMITTER_EMAIL
is optional. If you omit those, we default to the settings from your (global) git configuration.
If you run semantic-rs without any arguments, it operates on your current working directory:
$ export GH_TOKEN=<GHTOKEN>
$ export CARGO_TOKEN=<CARGOTOKEN>
$ export GIT_COMMITTER_NAME=<Your name>
$ export GIT_COMMITTER_EMAIL=<Your email>
$ semantic-rs
#...
By default it runs in dry-run mode. This means it doesn't perform changes automatically. You see which steps would be performed and also the resulting changelog.
To perform the changes, pass -w
as an argument:
$ semantic-rs -w=yes
This performs the following operations:
- Create or update
Changelog.md
containing everything that changed - Create a new commit containing the following changes:
Changelog.md
- An updated
Cargo.toml
with the new version number
- Create a new annotated git tag pointing to the last commit created recently and including the Changelog for the new version
- A new version published to [crates.io](crates.io)
- A new release on GitHub
- Push the new commit and tag to GitHub
Development
Requirements:
- cmake
- OpenSSL development package
- Ubuntu:
libssl-dev
,pkg-config
,zlib1g-dev
- Mac Homebrew:
openssl
- Ubuntu:
- Rust 1.15 or later
For OS X > 10.10
Note that since OS X 10.11 Apple doesn't ship development headers for OpenSSL anymore. In order to get it working, you need to run cargo with these variables configured:
OPENSSL_INCLUDE_DIR=`brew --prefix openssl`/include \
OPENSSL_LIB_DIR=`brew --prefix openssl`/lib \
cargo build
Build locally
Clone this project:
$ git clone [email protected]:semantic-rs/semantic-rs.git
As a test project you can use this one: https://github.com/badboy/test-project.
Clone it as well:
$ git clone https://github.com/badboy/test-project.git
In your top level directory there should be now the following two folders:
$ ls -l
semantic-rs
test-project
Change into the semantic-rs folder and run cargo build
.
Then you can run semantic-rs against the test project:
$ cargo run -- -p ../test-project
Compiling semantic-rs v0.1.0 (file:///Users/janschulte/projects/semantic-rs/semantic-rs)
Running `target/debug/semantic-rs -p ../test-project`
semantic.rs ๐
Analyzing your repository
Current version: 2.0.3
Analyzing commits
Commits analyzed. Bump would be Minor
New version would be: 2.1.0
Would write the following Changelog:
====================================
## v2.1.0 (2016-07-03)
#### Features
* Math mode ([24afa46f](24afa46f))
#### Bug Fixes
* Into the void ([9e54f4bf](9e54f4bf))
====================================
Would create annotated git tag
Since -w yes
was not passed, it only prints out what it would do. Note that if you run it on your local machine the output may differ.
Running the tests
To run semantic-rs's tests:
- unit tests:
cargo test
. - integration tests:
./tests/integration/run-locally.sh
.
Run semantic-rs in CI environment
Make sure to set the CI=true
environment variable to disable dry-run mode.
Contributing
Bug reports and pull requests are welcome on GitHub. You can find more information about contributing in the CONTRIBUTING.md. This project is intended to be a safe, welcoming space for collaboration and discussion, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
This project is licensed under the MIT license.
*Note that all licence references and agreements mentioned in the semantic-rs README section above
are relevant to that project's source code only.