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

Allow user to configure more variables for IRC server connection (e.g. port, SSL certs, etc.) #113

Closed
alcir opened this issue Jan 9, 2019 · 22 comments · Fixed by #355
Closed
Assignees
Labels
improvement Improves on something that already exists IRC Issues relating to the IRC bridge
Milestone

Comments

@alcir
Copy link

alcir commented Jan 9, 2019

Summary

Allow user to configure more parts of the IRC server connection (e.g. server port, using self-signed TLS certs, etc.)

Background

IRC servers are a wild world. Everyone can do things a little bit differently or deploy their network in a different way. Most of the current developers run the bot on Freenode, so we haven't thought about other bots as much. However, to make the bot more useful for more people, more options should be opened up for configuration for those who need it.

Details

Implementation should be straightforward. New env variables should be created for the following:

  • IRC server port
  • Allow expired / self-signed TLS certificates

These env variables should be used when negotiating the connection to the IRC server, instead of using hard-coded defaults. For our purposes, we can ship the Freenode defaults in our env.example file.

Outcome

More people can use the bot on a range of different IRC networks, outside of only Freenode


Original comment:

There is a way to specify IRC server port as well as SSL self signed certificate or turning on debug in the .env file or as environment variables?

@alcir alcir changed the title IRC porta and other variables IRC port and other variables Jan 9, 2019
@alcir
Copy link
Author

alcir commented Jan 9, 2019

I mean the variables you can see in node_modules/irc/lib/irc.js

@jwflory
Copy link
Member

jwflory commented Feb 16, 2019

@alcir Currently there is not a way to specify these things in Teleirc. This is a good candidate issue for v1.4. We'll review issues for the next sprint once v1.3 is released.

@jwflory jwflory added this to the v1.4 milestone Feb 16, 2019
@jwflory jwflory changed the title IRC port and other variables Allow user to configure more variables for IRC server connection (e.g. port, SSL certs, etc.) Mar 3, 2019
@jwflory jwflory self-assigned this Mar 3, 2019
@jwflory jwflory added improvement Improves on something that already exists priority:high and removed priority:low labels Mar 3, 2019
@jwflory
Copy link
Member

jwflory commented Mar 3, 2019

Discussed in 2019-03-02 developer meeting.


This ticket was accepted for the v1.4 sprint.

We agreed this is a high-priority feature because it makes the bot more useful for more people. The implementation should be straightforward. I plan to work on this during the March sprint.

Tjzabel added a commit that referenced this issue Mar 3, 2019
@jwflory jwflory closed this as completed in 1207f99 Mar 3, 2019
@jwflory
Copy link
Member

jwflory commented Mar 3, 2019

Uhh, actually @Tjzabel meant to close issue 112 with that commit, not this PR. Reopening.

@jwflory jwflory reopened this Mar 3, 2019
@Tjzabel
Copy link
Member

Tjzabel commented Mar 4, 2019

@jwflory thanks for the catch!

@jwflory
Copy link
Member

jwflory commented Mar 30, 2019

Discussed in 2019-03-30 Teleirc developer meeting.


I plan to do research this week for this ticket. I hope to have an idea of what to include and change for this by the next developer meeting on April 6th. I hope to have a final implementation by April 13th. I left the final week open in case of delays before the end of the v1.4 window on April 20th.

@jwflory jwflory modified the milestones: v1.4, v1.3.1 Apr 6, 2019
@jwflory
Copy link
Member

jwflory commented Apr 6, 2019

Discussed during 2019-04-06 developer meeting.


I have no major updates yet. Still planning to get this done in the next week.

@jwflory
Copy link
Member

jwflory commented Apr 10, 2019

I'm caught up in some of our other work for our new logo and planning our presence at the Imagine RIT festival this month. I suspect I will not have time to work on this before the end of the Spring 2019 semester, but I will try to do what I can.

@jwflory jwflory removed their assignment Apr 10, 2019
@jwflory
Copy link
Member

jwflory commented Jun 12, 2019

@Tjzabel No worries. I am equally guilty of doing the same at times too. 😂

@jwflory jwflory added this to the v2.0.0 milestone Feb 16, 2020
@jwflory jwflory added IRC Issues relating to the IRC bridge and removed good first issue Good for newcomers help wanted Anyone is welcome to help us with this! labels Feb 27, 2020
@jwflory
Copy link
Member

jwflory commented Feb 27, 2020

@RITlug/teleirc-developers-commit-access Any thoughts on this from a v2.0.0 perspective?

@Tjzabel
Copy link
Member

Tjzabel commented Feb 27, 2020

@jwflory I think having feature parity with where we currently stand is good enough. What other specific IRC features are part of the closing criteria? If they don't take a lot of time to implement, I am okay with adding this to the v2.0 release

@jwflory jwflory modified the milestones: v2.0.0, v2.x.x, v2.1.0 May 24, 2020
@jwflory
Copy link
Member

jwflory commented May 24, 2020

  • Metadata edited:
    • Milestone (v2.x.x ➡️ v2.1.0)

@jwflory
Copy link
Member

jwflory commented Oct 11, 2020

Discussed in 2020-10-11 meeting.


I'm going to work on this one for this sprint. This will be my first code contribution to the v2 branch, and first time really getting into Go… so let's see where this goes. 😉

jwflory added a commit to jwflory/teleirc that referenced this issue Oct 29, 2020
This commit reworks the IRC-side configuration options to support new
parameters and configuration options:

* **IRC_BOT_NAME**: IRC bot nick. Already existed, but now better
  documentation alongside other confusingly-named variables.
* **IRC_BOT_REALNAME**: `REALNAME` field support. Allows freeform text.
  Added bot advertisement as a default option if left unset.
* **IRC_BOT_IDENT**: Seldom used, but occasionally useful ident field.
  Overridden if NickServ credentials provided.
* **IRC_NICKSERV_USER**: Explicitly set a NickServ username for a bot.
  Previously used the `IRC_BOT_NAME`, but those are not always identical
  in all situations.

This commit also reworks the `env.example` file to better organize all
IRC options, in addition to adding the new ones. I also expanded and
reworked the config file glossary in the docs.

This Pull Request does not implement tests, but I would like to ask to
follow up on this in a subsequent Pull Request, preferably during the
upcoming testing sprint.

Fixes RITlug#113. cc: @alcir

Signed-off-by: Justin W. Flory (he/him) <[email protected]>
jwflory added a commit to jwflory/teleirc that referenced this issue Oct 29, 2020
This commit reworks the IRC-side configuration options to support new
parameters and configuration options:

* **IRC_BOT_NAME**: IRC bot nick. Already existed, but now better
  documentation alongside other confusingly-named variables.
* **IRC_BOT_REALNAME**: `REALNAME` field support. Allows freeform text.
  Added bot advertisement as a default option if left unset.
* **IRC_BOT_IDENT**: Seldom used, but occasionally useful ident field.
  Overridden if NickServ credentials provided.
* **IRC_NICKSERV_USER**: Explicitly set a NickServ username for a bot.
  Previously used the `IRC_BOT_NAME`, but those are not always identical
  in all situations.

This commit also reworks the `env.example` file to better organize all
IRC options, in addition to adding the new ones. I also expanded and
reworked the config file glossary in the docs.

This Pull Request does not implement tests, but I would like to ask to
follow up on this in a subsequent Pull Request, preferably during the
upcoming testing sprint.

Fixes RITlug#113. cc: @alcir

Signed-off-by: Justin W. Flory (he/him) <[email protected]>
@jwflory
Copy link
Member

jwflory commented Oct 29, 2020

Fixed in Pull Request #355.

@jwflory
Copy link
Member

jwflory commented Oct 31, 2020

@alcir Keep an eye out for this feature in v2.1.0 coming within the next week.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
improvement Improves on something that already exists IRC Issues relating to the IRC bridge
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants