many changes, see full commit message

- Renamed here_be_dragons() to main().
- Added daemon.py (doesn't do anything yet).
- Added GPL disclaimer to all python files and removed the shebang #!
  from all files.
- args is now defined outside any function in scripts.py
- Changed arguments of some functions in scripts.py

CHANGELOG.md

@@ -1,9 +1,12 @@
 # Changelog
 
-## [Unreleased][] - 2021-09-05
+## [Unreleased][] - 2021-09-06
 
-- Now logs to systemd journal. New dependency - `python3-systemd`
+- **Logging**: logs to systemd journal when run from systemd, stderr
+  otherwise.
+- New dependency `python3-systemd`
 - Fixed dependency order in systemd service
+- Added `--verbose` argument
 
 ## [v0.3.0][] - 2021-08-19
 
@@ -22,9 +25,9 @@
 
 ## [v0.1.0][] - 2021-06-19
 
-Initial version. At first, this was a shell script. Than it was converted
+Initial python version. At first, this was a shell script. Than it was
-into a single python file that did just what the shell script used to do.
+converted into a single python file that did just what the shell script
-The shell script was not given a version.
+used to do. The shell script was not given a version.
 
 [unreleased]: https://git.disroot.org/pranav/naxalnet/compare/v0.3.0...HEAD
 [v0.3.0]: https://git.disroot.org/pranav/naxalnet/compare/v0.2.0...v0.3.0

naxalnet/__init__.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python3
+# This file is part of naxalnet.
-
 # Copyright (C) 2021 The naxalnet Authors
 
 # This program is free software: you can redistribute it and/or modify
@@ -36,4 +35,4 @@ See README.md for documentation.
 #
 # In case you forgot to change the version, skip the number
 # and put the next number in the next commit.
-__version__ = "0.3.0a2.dev2"
+__version__ = "0.3.0a2.dev3"

naxalnet/__main__.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python3
+# This file is part of naxalnet.
-
 # Copyright (C) 2021 The naxalnet Authors
 
 # This program is free software: you can redistribute it and/or modify
@@ -15,13 +14,14 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
+
 """
 If called as python -m naxalnet, this file makes naxalnet run like
 it was called from the commandline. Try:
     python -m naxalnet --help
 """
 
-from naxalnet.scripts import here_be_dragons
+from naxalnet.scripts import main
 
 if __name__ == "__main__":
-    here_be_dragons()
+    main()

naxalnet/config.py

@@ -1,4 +1,18 @@
-#!/usr/bin/env python3
+# This file is part of naxalnet.
+# Copyright (C) 2021 The naxalnet Authors
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
 config.py

naxalnet/daemon.py

@@ -0,0 +1,59 @@
+# This file is part of naxalnet.
+# Copyright (C) 2021 The naxalnet Authors
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+"""
+daemon.py
+---------
+
+The daemon part. This is currently under construction.
+"""
+
+import logging
+from naxalnet.iwd import IWD
+
+
+class Daemon:
+    """implements the daemon part"""
+
+    logger = logging.getLogger(__name__)
+
+    def __init__(self):
+        iwd = IWD()
+        self.device_add_call = self.device_remove_call = None
+
+    def on_device_add(self, callback):
+        """
+        run the given callback with no arguments
+        every time a device is added
+        """
+        self.device_add_call = callback
+
+    def on_device_remove(self, callback):
+        """
+        run the given callback with no arguments
+        every time a device is removed
+        """
+        self.device_remove_call = callback
+
+    def register_callbacks(self):
+        """
+        register the callbacks with D-Bus
+        """
+
+    def start(self):
+        """
+        start the daemon
+        """

naxalnet/default.py

@@ -1,4 +1,18 @@
-#!/usr/bin/env python3
+# This file is part of naxalnet.
+# Copyright (C) 2021 The naxalnet Authors
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
 default.py

naxalnet/iwd.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python3
+# This file is part of naxalnet.
-
 # Copyright (C) 2021 The naxalnet Authors
 
 # This program is free software: you can redistribute it and/or modify
@@ -15,7 +14,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-
 """
 iwd.py
 ------

naxalnet/scripts.py

@@ -1,5 +1,4 @@
-#!/usr/bin/env python3
+# This file is part of naxalnet.
-
 # Copyright (C) 2021 The naxalnet Authors
 
 # This program is free software: you can redistribute it and/or modify
@@ -24,7 +23,7 @@ and doing the things this program is supposed to do.
 This file is named scripts.py because the original developer
 of this program could not think of a better name that suits this file.
 If you want to hack naxalnet, this is the right place to start.
-When run from the commandline, the function here_be_dragons() is called.
+When run from the commandline, the function main() is called.
 """
 
 import sys
@@ -40,16 +39,17 @@ from naxalnet.config import parse_args
 # from naxalnet.log import logger
 
 logger = logging.getLogger(__name__)
+args = parse_args()
 
 
-def copy_files(args):
+def copy_files():
     """
     Copy networkd configs to volatile dir.
     The D-Bus API does not support creating new interfaces
     or linking to bridges. So we use config files.
     See man:systemd.network(5)
     """
-
+    try:
         logger.info("Copying network config files")
         dest = Path(args.networkd_runtime_dir)
         src = Path(args.networkd_config_dir)
@@ -60,15 +60,18 @@ def copy_files(args):
         # Copy all files in src to dest
         for i in src.iterdir():
             copy(i, dest)
+    except PermissionError as error:
+        logger.error("Cannot copy file: %s", error)
+        sys.exit(3)
 
 
-def setup_devices(args):
+def setup_devices():
     """
     Setup wifi interfaces using iwd
     This function should be called every time an interface
     is connected or removed.
-    args should be what parse_args() returns
     """
+    try:
         iwd = IWD()
         devices = iwd.get_devices()
         adhoc_devices = []
@@ -124,9 +127,12 @@ def setup_devices(args):
             logger.warning(
                 "No device found to setup mesh. Make sure a WiFi adapter is connected"
             )
+    except DBusError:
+        logger.exception("Error while communicating with iwd")
+        sys.exit(4)
 
 
-def print_wifi(args):
+def print_wifi():
     """
     Prints the name and password of the adhoc, and ap
     from the arguments
@@ -141,14 +147,19 @@ def print_version():
     print(__version__)
 
 
-def here_be_dragons():
+def main():
     """
     This is where the magic happens!
     This function is run every time you
     execute naxalnet from the commandline
     """
-    args = parse_args()
 
+    if args.print_wifi:
+        print_wifi()
+        sys.exit(0)
+    elif args.version:
+        print_version()
+        sys.exit(0)
     # --verbose
     if args.verbose >= 2:
         loglevel = logging.DEBUG
@@ -164,23 +175,9 @@ def here_be_dragons():
     else:
         logging.basicConfig(level=loglevel)
 
-    if args.print_wifi:
+    copy_files()
-        print_wifi(args)
-        sys.exit(0)
-    elif args.version:
-        print_version()
-        sys.exit(0)
 
-    try:
+    setup_devices()
-        copy_files(args)
-    except PermissionError as error:
-        logger.error("Cannot copy file: %s", error)
-        sys.exit(3)
 
-    try:
-        setup_devices(args)
-    except DBusError:
-        logger.exception("Error while communicating with iwd")
-        sys.exit(4)
     # naxalnet prints Bye if no errors occured
     logger.info("Bye")

setup.cfg

@@ -27,7 +27,7 @@ install_requires =
 
 [options.entry_points]
 console_scripts =
-    naxalnet = naxalnet.scripts:here_be_dragons
+    naxalnet = naxalnet.scripts:main
 
 [options.data_files]
 lib/systemd/system =