8000 SMQ-2533 - Rename Magistrala to SuperMQ by dborovcanin · Pull Request #2560 · absmach/supermq · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

SMQ-2533 - Rename Magistrala to SuperMQ #2560

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

Merged
merged 11 commits into from
Dec 4, 2024
Merged

Conversation

dborovcanin
Copy link
Collaborator

What type of PR is this?

What does this do?

This is a renaming PR that renames code references and naming.

Which issue(s) does this PR fix/relate to?

Resolves #2533

Have you included tests for your changes?

No.

Did you document any new/modified feature?

N/A

Notes

N/A

@dborovcanin dborovcanin force-pushed the rename branch 2 times, most recently from 68bf085 to f2d6260 Compare December 2, 2024 15:21
svcerr "github.com/absmach/magistrala/pkg/errors/service"
"github.com/absmach/magistrala/pkg/policies"
"github.com/absmach/magistrala/pkg/roles"
mg "github.com/absmach/supermq"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
mg "github.com/absmach/supermq"
smq "github.com/absmach/supermq"

"github.com/absmach/magistrala/pkg/roles"
mg "github.com/absmach/supermq"
mgauth "github.com/absmach/supermq/auth"
grpcChannelsV1 "github.com/absmach/supermq/internal/grpc/channels/v1"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgauth can we have like smqAuth ?

	smqAuth "github.com/absmach/supermq/auth"

"github.com/absmach/supermq/internal/api"
"github.com/absmach/supermq/pkg/apiutil"
mgauthn "github.com/absmach/supermq/pkg/authn"
roleManagerHttp "github.com/absmach/supermq/pkg/roles/rolemanager/api"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgauthn can we have like smqAuthn ?

	smqAuthn "github.com/absmach/supermq/pkg/authn"

"github.com/absmach/supermq/internal/api"
"github.com/absmach/supermq/internal/testsutil"
mglog "github.com/absmach/supermq/logger"
"github.com/absmach/supermq/pkg/apiutil"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mglog can we have like smqLog ?

	smqLog "github.com/absmach/supermq/logger"

mglog "github.com/absmach/supermq/logger"
"github.com/absmach/supermq/pkg/apiutil"
mgauthn "github.com/absmach/supermq/pkg/authn"
authnmocks "github.com/absmach/supermq/pkg/authn/mocks"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgauthn can we have like smqAuthn ?

	smqAuthn "github.com/absmach/supermq/pkg/authn"

mglog "github.com/absmach/supermq/logger"
authsvcAuthn "github.com/absmach/supermq/pkg/authn/authsvc"
mgauthz "github.com/absmach/supermq/pkg/authz"
authsvcAuthz "github.com/absmach/supermq/pkg/authz/authsvc"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgauthz can we have like smqAuthz ?

	smqAuthz "github.com/absmach/supermq/pkg/authz"

@@ -4,7 +4,7 @@ SPDX-License-Identifier: Apache-2.0 -->
<!--

Pull request title should be `MG-XXX - description` or `NOISSUE - description` where XXX is ID of the issue that this PR relate to.
Please review the [CONTRIBUTING.md](https://github.com/absmach/magistrala/blob/main/CONTRIBUTING.md) file for detailed contributing guidelines.
Please review the [CONTRIBUTING.md](https://github.com/absmach/supermq/blob/main/CONTRIBUTING.md) file for detailed contributing guidelines.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Please review the [CONTRIBUTING.md](https://github.com/absmach/supermq/blob/main/CONTRIBUTING.md) file for detailed contributing guidelines.
Pull request title should be `SMQ-XXX - description` or `NOISSUE - description` where XXX is ID of the issue that this PR relate to.

Copy link
Contributor
@arvindh123 arvindh123 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"github.com/absmach/supermq/channels/mocks"
"github.com/absmach/supermq/clients"
mgclients "github.com/absmach/supermq/clients"
clmocks "github.com/absmach/supermq/clients/mocks"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgclient can we have smqClients?

	smqclients "github.com/absmach/supermq/clients"

"github.com/absmach/magistrala/pkg/roles"
"github.com/absmach/supermq"
mgclients "github.com/absmach/supermq/clients"
grpcClientsV1 "github.com/absmach/supermq/internal/grpc/clients/v1"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgclient can we have smqClients?

	smqClients "github.com/absmach/supermq/clients"

"github.com/absmach/magistrala/pkg/transformers/senml"
"github.com/absmach/supermq/consumers"
"github.com/absmach/supermq/pkg/errors"
mgjson "github.com/absmach/supermq/pkg/transformers/json"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
mgjson "github.com/absmach/supermq/pkg/transformers/json"
smqJson "github.com/absmach/supermq/pkg/transformers/json"

"github.com/absmach/supermq/channels/mocks"
"github.com/absmach/supermq/clients"
mgapi "github.com/absmach/supermq/internal/api"
"github.com/absmach/supermq/internal/testsutil"
Copy link
Contributor
@arvindh123 arvindh123 Dec 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of mgapi can we have like smqAPI ?

	smqAPI "github.com/absmach/supermq/internal/api"

Copy link
Contributor
@arvindh123 arvindh123 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

repoerr "github.com/absmach/magistrala/pkg/errors/repository"
"github.com/absmach/magistrala/pkg/postgres"
rolesPostgres "github.com/absmach/magistrala/pkg/roles/repo/postgres"
mggroups "github.com/absmach/supermq/groups"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
mggroups "github.com/absmach/supermq/groups"
smqGroups "github.com/absmach/supermq/groups"

users/README.md Outdated

Setting `MG_AUTH_GRPC_CLIENT_CERT` and `MG_AUTH_GRPC_CLIENT_KEY` will enable TLS against the auth service. The service expects a file in PEM format for both the certificate and the key. Setting `MG_AUTH_GRPC_SERVER_CA_CERTS` will enable TLS against the auth service trusting only those CAs that are provided. The service expects a file in PEM format of trusted CAs.
Setting `SMQ_AUTH_GRPC_CLIENT_CERT` and `SMQ_AUTH_GRPC_CLIENT_KEY` will enable TLS against the auth service. The service expects a file in PEM format for both the certificate and the key. Setting `SMQ_AUTH_GRPC_SERVER_CA_CERTS` will enable TLS against the auth service trusting only those CAs that are provided. The service expects a file in PEM format of trusted CAs.

## Usage

For more information about service capabilities and its usage, please check out the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=users-openapi.yml).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For more information about service capabilities and its usage, please check out the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=users-openapi.yml).
For more information about service capabilities and its usage, please check out the [API documentation](https://docs.api.supermq.abstractmachines.fr/?urls.primaryName=users-openapi.yml).

auth/README.md Outdated
Setting `MG_AUTH_HTTP_SERVER_CERT` and `MG_AUTH_HTTP_SERVER_KEY` will enable TLS against the service. The service expects a file in PEM format for both the certificate and the key.
Setting `MG_AUTH_GRPC_SERVER_CERT` and `MG_AUTH_GRPC_SERVER_KEY` will enable TLS against the service. The service expects a file in PEM format for both the certificate and the key. Setting `MG_AUTH_GRPC_SERVER_CA_CERTS` will enable TLS against the service trusting only those CAs that are provided. The service expects a file in PEM format of trusted CAs. Setting `MG_AUTH_GRPC_CLIENT_CA_CERTS` will enable TLS against the service trusting only those CAs that are provided. The service expects a file in PEM format of trusted CAs.
Setting `SMQ_AUTH_HTTP_SERVER_CERT` and `SMQ_AUTH_HTTP_SERVER_KEY` will enable TLS against the service. The service expects a file in PEM format for both the certificate and the key.
Setting `SMQ_AUTH_GRPC_SERVER_CERT` and `SMQ_AUTH_GRPC_SERVER_KEY` will enable TLS against the service. The service expects a file in PEM format for both the certificate and the key. Setting `SMQ_AUTH_GRPC_SERVER_CA_CERTS` will enable TLS against the service trusting only those CAs that are provided. The service expects a file in PEM format of trusted CAs. Setting `SMQ_AUTH_GRPC_CLIENT_CA_CERTS` will enable TLS against the service trusting only those CAs that are provided. The service expects a file in PEM format of trusted CAs.

## Usage

For more information about service capabilities and its usage, please check out the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=auth.yml).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For more information about service capabilities and its usage, please check out the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=auth.yml).
For more information about service capabilities and its usage, please check out the [API documentation](https://docs.api.supermq.abstractmachines.fr/?urls.primaryName=auth.yml).


This folder contains an OpenAPI specifications for Magistrala API.
This folder contains an OpenAPI specifications for SuperMQ API.

View specification in Swagger UI at [docs.api.magistrala.abstractmachines.fr](https://docs.api.magistrala.abstractmachines.fr)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
View specification in Swagger UI at [docs.api.magistrala.abstractmachines.fr](https://docs.api.magistrala.abstractmachines.fr)
View specification in Swagger UI at [docs.api.supermq.abstractmachines.fr](https://docs.api.supermq.abstractmachines.fr)


The following is a set of guidelines to contribute to Magistrala and its libraries, which are
The following is a set of guidelines to contribute to SuperMQ and its libraries, which are
hosted on the [Abstract Machines Organization](https://github.com/absmach) on GitHub.

This project adheres to the [Contributor Covenant 1.2](http://contributor-covenant.org/version/1/2/0).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we don't have domain magistrala.com, if it is true, then we need to rename @magistrala.com to @abstractmachines.fr
I

cli/README.md Outdated
@@ -15,79 +15,79 @@ make cli
#### Get Magistrala Services Health Check
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### Get Magistrala Services Health Check
#### Get SuperMQ Services Health Check

Same we need in top of the file

@@ -119,4 +119,4 @@ To run service in a standalone mode, set `Clients_STANDALONE_EMAIL` and `Clients
For more information about service capabilities and its usage, please check out
the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=clients-openapi.yml).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=clients-openapi.yml).
the [API documentation](https://docs.api.supermq.abstractmachines.fr/?urls.primaryName=clients-openapi.yml).


Running this service outside of container requires working instance of the message broker service, clients service and Jaeger server.
To start the service outside of the container, execute the following shell script:

```bash
# download the latest version of the service
git clone https://github.com/absmach/magistrala
git clone https://github.com/absmach/supermq
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we are moving to magistrala repo then it should be

Suggested change
git clone https://github.com/absmach/supermq
git clone https://github.com/absmach/magistrala

be transformed into any valid format that specific consumer can understand. For example,
writers are consumers that can take a SenML or JSON message and store it.

Consumers are optional services and are treated as plugins. In order to
run consumer services, core services must be up and running.

For an in-depth explanation of the usage of `consumers`, as well as thorough
understanding of Magistrala, please check out the [official documentation][doc].
understanding of SuperMQ, please check out the [official documentation][doc].

For more information about service capabilities and its usage, please check out
the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=consumers-notifiers-openapi.yml).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
the [API documentation](https://docs.api.magistrala.abstractmachines.fr/?urls.primaryName=consumers-notifiers-openapi.yml).
the [API documentation](https://docs.api.supermq.abstractmachines.fr/?urls.primaryName=consumers-notifiers-openapi.yml).

@@ -1,31 +1,31 @@
# BOOTSTRAP SERVICE
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since bootstrap service will be in MG, we can revert the words to Magistrala in valid places

@@ -1,23 +1,23 @@
# Certs Service
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since certs service is going to be in Magistrala, we can change word SuperMQ to Magistrala in valid places

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We will probably keep certs as a part of IAM for SMQ.

Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
E859
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
if err != nil {
return fmt.Errorf("error loading connections file: %s", err)
}

mg := magistrala{}
mg := superMQ{}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please change mg to smq

In this same file we have word mgChan and mgCli

@dborovcanin dborovcanin merged commit 178aa46 into absmach:main Dec 4, 2024
6 of 7 checks passed
@dborovcanin dborovcanin deleted the rename branch December 4, 2024 10:17
felixgateru pushed a commit to felixgateru/supermq that referenced this pull request Dec 5, 2024
Signed-off-by: Dusan Borovcanin <borovcanindusan1@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Bug: Fix Linting Issues in Proto Files
2 participants
0