asdf-openssl2

openssl2 plugin

asdf-openssl2

openssl2 plugin

openssl2 plugin

[![asdf-openssl2 on YouTube][badge-yt]][youtube]

Get dynamically generated GitHub stats on your READMEs!

[](https://github.com/VadimDor/openssl2/blob/main/LICENSE) [](https://github.com/VadimDor/openssl2/releases/latest) [](https://github.com/VadimDor/openssl2/releases)   [](https://www.codefactor.io/repository/github/VadimDor/asdf-openssl2)

<!-- ALL-CONTRIBUTORS-BADGE:END -->

Note: if you like this project, feel free to buy me a swimming chance:

Build History

介绍

Features 🌈

• 🆓 100% free and open-source
• 🚀 Easy to setup with Docker
• [Tested in Docker:

⬆️ Back to Top

Contents

Index

Summary

Readme👀

• Installation🔧
• Usage⍨
• Usecase🔍
• Advanced🛡️
• Communities
• Change log🌳
• Review🚀
• FAQ⚙️
• Donate👋
• Thanks 🙏
• Privacy⚡
• Terms
• Dependencies
• Install
• Contributing
• License📫

Sponsors

Huge thanks to the sponsors helping to support🙋‍♀️ openssl2 plugin's development! <!-- readme: sponsors -start -->

12345

Description [↑]

This is plugin for asdf tool

Contributors

AllContributors ✨

Thanks goes to these wonderful people (emoji key):

Sean P. Myrick V19.1.7.2 💻 📖 📆 🛡️ 🔣 🖋 🎨 🚧 🤔

All Contributors 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

Stats

⬆️ Back to Top

Developing 🧱

For full development documentation, see: Developing

Before getting started, you'll need Git installed.

To set up the development environment get Code: git clone https://github.com/VadimDor/openssl2.git and cd asdf-openssl2

Repo Status:

⬆️ Back to Top

Dependencies

TODO: adapt these sections below

• bash, curl, tar: and POSIX utilities.
• SOME_ENV_VAR: set this environment variable in your shell config to load the correct version of tool x.

Install

Install asdf, then:

Plugin:

```sh asdf plugin add asdf-openssl2 # install the asdf-openssl2 plugin

or

asdf plugin add asdf-openssl2 https://github.com/VadimDor/openssl2.git

asdf asdf-openssl2 install-deps # install system-specific dependencies for downloading & building Openssl2 ```

To install Openssl2:

When available for the version and platform, the plugin will install pre-compiled binaries of Openssl2. If no binaries are available the plugin will build Openssl2 from source.

```sh

latest stable version of Openssl2

asdf install asdf-openssl2 latest

or latest stable minor/patch release of Openssl2 1.x.x

asdf install asdf-openssl2 latest:1

or latest stable patch release of Openssl2 1.6.x

asdf install asdf-openssl2 latest:1.6

or specific patch release

asdf install asdf-openssl2 1.6.8 ```

To install a nightly build of Openssl2:

```sh

nightly unstable build of devel branch

asdf install asdf-openssl2 ref:devel

or nightly unstable build of version-1-6 branch, i.e. the latest 1.6.x release + any recent backports from devel

asdf install asdf-openssl2 ref:version-1-6

or nightly unstable build of version-1-4 branch, i.e. the latest 1.4.x release + any recent backports from devel

asdf install asdf-openssl2 ref:version-1-4

or nightly unstable build of version-1-2 branch, i.e. the 1.2.x release + any recent backports from devel

asdf install asdf-openssl2 ref:version-1-2

or nightly unstable build of version-1-0 branch, i.e. the 1.0.x release + any recent backports from devel

asdf install asdf-openssl2 ref:version-1-0 ```

To build a specific git commit or branch of Openssl2:

```sh

build using latest commit from the devel branch

asdf install asdf-openssl2 ref:HEAD

build using the specific commit 7d15fdd

asdf install asdf-openssl2 ref:7d15fdd

build using the tagged release v1.6.8

asdf install asdf-openssl2 ref:v1.6.8 ```

asdf-openssl2:

```shell

Show all installable versions

asdf list-all asdf-openssl2

Install specific version

asdf install asdf-openssl2 latest

Set a version globally (on your ~/.tool-versions file)

asdf global asdf-openssl2 latest

Now asdf-openssl2 commands are available

openssl2 --version ```

Check asdf readme for more instructions on how to install & manage versions.

asdf-openssl2

asdf-openssl2 allows you to quickly install any version of Openssl2.

asdf-openssl2 is intended for end-users and continuous integration. Whether macOS or Linux, x86 or ARM - all you'll need to install Openssl2 is bash.

To set the default version of Openssl2 for your user:

sh asdf global asdf-openssl2 latest:1.6

This creates a .tool-versions file in your home directory specifying the Openssl2 version.

To set the version of Openssl2 for a project directory:

sh cd my-project asdf local asdf-openssl2 latest:1.6

This creates a .tool-versions file in the current directory specifying the Openssl2 version. For additional plugin usage see the asdf documentation.

asdf-openssl2 packages

asdf-openssl2 packages are installed in ~/.asdf/installs/asdf-openssl2/<asdf-openssl2-version>/asdf-openssl2/pkgs, unless a asdf-openssl2deps directory exists in the directory where asdf-openssl2 install is run from.

See the asdf-openssl2 documentation for more information about asdf-openssl2deps.

Continuous Integration

A simple example using GitHub Actions:

```yaml name: Build on: push: paths-ignore: - README.md

env: GITHUBTOKEN: ${{ secrets.GITHUBTOKEN }}

jobs: build: name: Test runs-on: ${{ matrix.os }} matrix: include: # Test against stable Openssl2 builds on linux - os: ubuntu-latest asdf-openssl2-version: latest:1.6 - os: ubuntu-latest asdf-openssl2-version: latest:1.4

    # Test against unstable nightly Openssl2 builds on macos (faster than building from source)
    - os: macos-latest
      asdf-openssl2-version: ref:version-1-6
    - os: macos-latest
      asdf-openssl2-version: ref:version-1-4
steps:
  - name: Checkout
    uses: actions/checkout@v4
  - name: Install Openssl2
    uses: asdf-vm/actions/install@v1
    with:
      tool_versions: |
        asdf-openssl2 ${{ matrix.asdf-openssl2-version }}
  - name: Run tests
    run: |
      asdf local asdf-openssl2 ${{ matrix.asdf-openssl2-version }}
      asdf-openssl2 develop -y
      asdf-openssl2 test
      asdf-openssl2 examples

```

Continuous Integration on Non-x86 Architectures

Using uraimo/run-on-arch-action:

```yaml name: Build on: push: paths-ignore: - README.md

jobs: testnonx86: name: Test asdf-openssl2-${{ matrix.asdf-openssl2-version }} / debian-buster / ${{ matrix.arch }} strategy: fail-fast: false matrix: include: - asdf-openssl2-version: ref:version-1-6 arch: armv7 - asdf-openssl2-version: ref:version-1-2 arch: aarch64

runs-on: ubuntu-latest
steps:
  - name: Checkout Openssl2 project
    uses: actions/checkout@v4

  - uses: uraimo/run-on-arch-action@v2
    name: Install Openssl2 & run tests
    with:
      arch: ${{ matrix.arch }}
      distro: buster

      dockerRunArgs: |
        --volume "${HOME}/.cache:/root/.cache"

      setup: mkdir -p "${HOME}/.cache"

      shell: /usr/bin/env bash

      install: |
        set -uexo pipefail
        # Install asdf and dependencies
        apt-get update -q -y
        apt-get -qq install -y build-essential curl git
        git clone https://github.com/asdf-vm/asdf.git "${HOME}/.asdf" --branch v0.10.2

      env: |
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      run: |
        set -uexo pipefail
        . "${HOME}/.asdf/asdf.sh"

        # Install asdf-openssl2 and dependencies
        git clone https://github.com/VadimDor/openssl2.git ~/asdf-openssl2 --branch main --depth 1
        asdf plugin add asdf-openssl2 ~/asdf-openssl2
        asdf asdf-openssl2 install-deps -y

        # Install Openssl2
        asdf install asdf-openssl2 ${{ matrix.asdf-openssl2-version }}
        asdf local asdf-openssl2 ${{ matrix.asdf-openssl2-version }}

        # Run tests
        asdf-openssl2 develop -y
        asdf-openssl2 test
        asdf-openssl2 examples

```

Stable binaries

asdf-openssl2-lang.org supplies pre-compiled stable binaries of Openssl2 for:

Linux:

• x86_64 (gnu libc)
• x86 (gnu libc)

Unstable nightly binaries

asdf-openssl2-lang/nightlies supplies pre-compiled unstable binaries of Openssl2 for:

Linux:

• x86_64 (gnu libc)
• x86 (gnu libc)
• aaarch64 (gnu libc)
• armv7l (gnu libc)

macOS:

• x86_64

Updating asdf and asdf-openssl2

sh asdf update asdf plugin update asdf-openssl2 main

Testing

This project uses bats for unit testing. Please follow existing patterns and add unit tests for your changeset. Dev dependencies for unit tests are installed via:

shell cd ~/.asdf/plugins/asdf-openssl2 npm install --include=dev

Run tests with:

sh npm run test

Linting

This project uses lintball to auto-format code. Please ensure your changeset passes linting. Enable the githooks with:

sh git config --local core.hooksPath .githooks

Want to get support for "openssl2 plugin"?

• Check out the Discussions to ask questions.

Want to learn more about OPA?

• Go to project homepage to get started with documentation and tutorials, for news about it, community, policy and roadmaps.
• Check out the ADOPTERS.md file for a list of production adopters. Does your organization use "openssl2 plugin" in production? Support it by submitting a PR to add your organization to the list with a short description of your use cases (or at list star this repository :) )!

Contributing

First and foremost, all contributions and pull requests are welcome! * The steps involved when making a contribution are explained in the Contributing Guide to learn how to make your first contribution. * File a GitHub Issue to request features or report bugs. We look forward to your contributions! * The contributors list is located here.

Keep in touch

• Subscribe via email Get the latest updates and (benefits) in a timely manner.
• Follow our Twitter
• Join Telegram channel Receive the latest news
• Question feedback

Fork this repo, then run:

sh rm -rf ~/.asdf/plugins/asdf-openssl2 git clone git@github.com:<your-username>/asdf-openssl2.git ~/.asdf/plugins/asdf-openssl2

Thanks goes to these contributors!

Star History 🌟🏆🙌

Discussions [↑]

Feel free to give any ideas for future improvements here, ask any questions you have here

🔐Reporting Security Vulnerabilities🧱🛎️

Please report vulnerabilities by any channel.We will send a confirmation message to acknowledge that we have received the report and then we will send additional messages to follow up once the issue has been investigated.

Metrics [↑]

Code of Conduct [↑]

This project follows the 👉Contributor Covenant Code of Conduct.

License [↑]

See LICENSE📜 © Vadim Dor

TDLR; You can do whatever you like with this: use it in private or commercial settings, redistribute and modify it. But you must display this license and credit the author. There is no warranty that this app will work as expected, and the author cannot be held liable for anything that goes wrong. For more info, see TLDR Legal's Explanation of MIT

⬆️ Back to Top

Thank you for Visiting

TODO: adapt these sections above

Author

VadimDor

Author

VadimDor