Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve main SDK page #1047

Merged
merged 3 commits into from
Oct 25, 2023
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
232 changes: 120 additions & 112 deletions source/developers/minio-drivers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,113 +12,75 @@ Software Development Kits (SDK)

MinIO publishes the following Software Development Kits (SDK):

1. :ref:`.NET <dotnet-sdk>`
2. :ref:`Golang <go-sdk>`
3. :ref:`Haskell <haskell-sdk>`
4. :ref:`Java <java-sdk>`
5. :ref:`JavaScript <javascript-sdk>`
6. :ref:`Python <python-sdk>`
7. :ref:`C++ <cpp-sdk>`
- :ref:`Go <go-sdk>`
- :ref:`Python <python-sdk>`
- :ref:`Java <java-sdk>`
- :ref:`.NET <dotnet-sdk>`
- :ref:`JavaScript <javascript-sdk>`
- :ref:`C++ <cpp-sdk>`
- :ref:`Haskell <haskell-sdk>`

.. _cpp-sdk:

C++ (``minio-cpp``)
-------------------


Reference
`MinIO C++ SDK Reference <https://minio-cpp.min.io/>`__
.. _go-sdk:

Install
- ``vcpkg``
Go
--

.. code-block:: shell
:class: copyable
GitHub: `minio/minio-go <https://github.com/minio/minio-go>`__

vcpkg install minio-cpp
Latest Version: |go-sdk-version|

- Source

.. code-block:: shell
:class: copyable
Quickstart Guide: :doc:`/developers/go/minio-go`

git clone https://github.com/minio/minio-cpp
cd minio-cpp
wget --quiet -O vcpkg-master.zip https://github.com/microsoft/vcpkg/archive/refs/heads/master.zip
unzip -qq vcpkg-master.zip
./vcpkg-master/bootstrap-vcpkg.sh
./vcpkg-master/vcpkg integrate install
cmake -B ./build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=./vcpkg-master/scripts/buildsystems/vcpkg.cmake
cmake --build ./build --config Debug

.. _dotnet-sdk:

.NET (``minio-dotnet``)
-----------------------
Download from GitHub
.. code-block:: shell
:class: copyable

Latest Version
|dotnet-sdk-version|
go install github.com/minio/minio-go/v7@latest

Reference
:doc:`MinIO .NET SDK Reference </developers/dotnet/minio-dotnet>`

Download from NuGet
Run the following command in the NuGet Package Manager Console.
.. _python-sdk:

.. code-block:: shell
:class: copyable
Python
------

PM> Install-Package Minio
GitHub: `minio/minio-py <https://github.com/minio/minio-py>`__

.. _go-sdk:
Latest Version: |python-sdk-version|

Go (``minio-go``)
-----------------
Quickstart Guide: :doc:`/developers/python/minio-py`
feorlen marked this conversation as resolved.
Show resolved Hide resolved

Latest Version
|go-sdk-version|
Install Methods
- pip

Reference
:doc:`MinIO Go SDK Reference </developers/go/minio-go>`
.. code-block:: shell
:class: copyable

Download from GitHub
.. code-block:: go
:class: copyable
pip3 install minio

go get github.com/minio/minio-go/v7
- source

.. _haskell-sdk:
.. code-block:: shell
:class: copyable

Haskell (``minio-hs``)
----------------------
git clone https://github.com/minio/minio-py
cd minio-py
python setup.py install

Latest Version
|haskell-sdk-version|

Reference
:doc:`MinIO Haskell SDK Reference </developers/haskell/minio-haskell>`

Install
Add ``minio-hs`` to your project's ``.cabal`` dependencies section.

or
.. _java-sdk:

If you are using ``hpack``, add ``minio-hs`` to your ``package.yaml`` file.
Java
----

.. _java-sdk:
GitHub: `minio/minio-java <https://github.com/minio/minio-java>`__

Java (``minio-java``)
---------------------
Latest version: |java-sdk-version|

Latest version
|java-sdk-version|
Reference: :ref:`minio-java-quickstart`
feorlen marked this conversation as resolved.
Show resolved Hide resolved

Reference
:ref:`MinIO Java SDK Reference <minio-java-quickstart>`

Install methods
- Maven

.. code-block:: java
:class: copyable
:substitutions:
Expand All @@ -130,82 +92,128 @@ Install methods
</dependency>

- Gradle

.. code-block:: java
:class: copyable
:substitutions:

dependencies {
implementation("io.minio:minio:|java-sdk-version|")
}
}

- JAR

Download the latest JAR file for |java-sdk-version| of the SDK from |java-jar-url|.


.. _dotnet-sdk:

.NET
----

GitHub: `minio/minio-dotnet <https://github.com/minio/minio-dotnet>`__

Latest Version: |dotnet-sdk-version|

Quickstart Guide: :doc:`/developers/dotnet/minio-dotnet`

Download from NuGet
Run the following command in the NuGet Package Manager Console.

.. code-block:: shell
:class: copyable

PM> Install-Package Minio


.. _javascript-sdk:

JavaScript (``minio-js``)
-------------------------
JavaScript
----------

GitHub: `minio/minio-js <https://github.com/minio/minio-js>`__

Latest Version
|javascript-sdk-version|
Latest Version: |javascript-sdk-version|

Reference
:doc:`MinIO JavaScript SDK Reference </developers/javascript/minio-javascript>`
Quickstart Guide: :doc:`/developers/javascript/minio-javascript`

Install
- NPM

.. code-block:: shell
:class: copyable

npm install --save minio

- Source

.. code-block:: shell
:class: copyable

git clone https://github.com/minio/minio-js
cd minio-js
npm install
npm install -g
npm install -g

- TypeScript

.. code-block:: shell
:class: copyable

npm install --save-dev @types/minio

.. _python-sdk:

Python (``minio-py``)
---------------------
.. _cpp-sdk:

Latest Version
|python-sdk-version|
C++
---

GitHub: `minio/minio-cpp <https://github.com/minio/minio-cpp>`__

Latest version: |cpp-sdk-version|

Reference: `MinIO C++ SDK Reference <https://minio-cpp.min.io/>`__

Install
- ``vcpkg``

Reference
:doc:`MinIO Python SDK Reference </developers/python/minio-py>`

Install Methods
- pip

.. code-block:: shell
:class: copyable

pip3 install minio
vcpkg install minio-cpp

- source
- Source

.. code-block:: shell
:class: copyable

git clone https://github.com/minio/minio-py
cd minio-py
python setup.py install
git clone https://github.com/minio/minio-cpp
cd minio-cpp
wget --quiet -O vcpkg-master.zip https://github.com/microsoft/vcpkg/archive/refs/heads/master.zip
unzip -qq vcpkg-master.zip
./vcpkg-master/bootstrap-vcpkg.sh
./vcpkg-master/vcpkg integrate install
cmake -B ./build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=./vcpkg-master/scripts/buildsystems/vcpkg.cmake
cmake --build ./build --config Debug


.. _haskell-sdk:

Haskell
-------

GitHub: `minio/minio-hs <https://github.com/minio/minio-hs>`__

Latest Version: |haskell-sdk-version|

Quickstart Guide: :doc:`/developers/haskell/minio-haskell`

Install
Add ``minio-hs`` to your project's ``.cabal`` dependencies section.

or

If you are using ``hpack``, add ``minio-hs`` to your ``package.yaml`` file.

..
Rust SDK repo does not have any releases yet. Once released, unblock this section and add to toctree.
Expand All @@ -232,10 +240,10 @@ Install Methods
:titlesonly:
:hidden:
:maxdepth: 1

/developers/dotnet/minio-dotnet

/developers/go/minio-go
/developers/haskell/minio-haskell
/developers/python/minio-py
/developers/dotnet/minio-dotnet
/developers/java/minio-java
/developers/javascript/minio-javascript
/developers/python/minio-py
/developers/haskell/minio-haskell