Netport is a tool for managing single-access resources on the target Unix machine. Netport manages the access to different types of resources on the operating system by not allowing multiple requests to the same resource. For example ports, files, processes, network interfaces, and more...
flowchart TD
client([Client])
server[/Netport Server\]
database[(Database)]
resources{{Resources}}
ports(Ports)
interfaces(Interfaces)
fs(File System)
proc(System Processes)
info(System Info)
client <--REST API requests--> server
server <--stores server state---> database
server <----> resources
resources --- ports
resources --- interfaces
resources --- fs
resources --- proc
resources --- info
Netport runs in a single python process on the target machine. It uses the FastAPI framework to make a high performance and easy to use REST api server. By using this api, users can easily perform a variety of requests to various resources.
There are many types of requests that can be made:
- Acquire a free port.
- Check if file exists
- Declare that a file is being used
- Start a process
- Get a list of already acquired resources
And many more...
In order to maintain an active memory of the used resources, Netport communicates with a database. There are 2 types of supported databases that netport uses:
- Redis database
- Local pythonic database.
Both databases serve the same purpose for netport, but their inner functionality still a bit different, with one draw back for the local database. The local database doesn't save netport's state after a shutdown or a reboot.
The decision whether to use redis DB or a local one, depends by the user. In case of an unexpected shutdown, with redis the state of netport will be stored and on reboot it will continue from where it stopped. On the other hand, for much simpler systems this feature might be unnecessary complicated.
Make sure that python is installed on your machine (3.7 and above). Open your terminal and run the following command:
pip install netportIt is advised to use a dedicated python virtual environment for netport.
Install poetry by following the instructions here.
- Clone this repository:
git clone https://github.com/IgalKolihman/netport.git- Install the development environment:
poetry install --with devPlease follow the installation procedure to be able to run Netport. After that netport will be available to you as long as you are using it's virtual environment.
To run netport with basic configurations, run:
netportAfter executing this command, a link will appear in the terminal to the server's url. The API documentation will be available at: "http://host_ip:port/docs"
For more advanced information regarding netport execution, run the following command:
netport -h