Skip to content

Commit

Permalink
Merge pull request #13 from vroncevic/dev
Browse files Browse the repository at this point in the history
[samba_manager] Updated docs
  • Loading branch information
vroncevic committed Dec 16, 2023
2 parents dabcd50 + d2e2a42 commit 0c2d13d
Show file tree
Hide file tree
Showing 53 changed files with 14,578 additions and 16,890 deletions.
20 changes: 0 additions & 20 deletions .github/workflows/samba_manager_docker_checker.yml

This file was deleted.

35 changes: 10 additions & 25 deletions .github/workflows/samba_manager_shell_checker.yml
@@ -1,37 +1,22 @@
name: samba_manager shell checker
name: samba_manager_shell_checker
on:
push:
branches: [ master ]
paths:
- 'sh_tool/**'
pull_request:
branches: [ master ]
paths:
- 'sh_tool/**'
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Check syntax script
id: syntax_checker
run: |
bash -n sh_tool/bin/nmb_operation.sh && script_1=0 || script_1=1
bash -n sh_tool/bin/samba_manager.sh && script_2=0 || script_2=1
bash -n sh_tool/bin/smb_info.sh && script_3=0 || script_3=1
bash -n sh_tool/bin/smb_list.sh && script_4=0 || script_4=1
bash -n sh_tool/bin/smb_operation.sh && script_5=0 || script_5=1
bash -n sh_tool/bin/smb_version.sh && script_6=0 || script_6=1
bash -n sh_tool/bin/winbind_operation.sh && script_7=0 || script_7=1
[[ $script_1 -eq 0 && $script_2 -eq 0 && $script_3 -eq 0 && $script_4 -eq 0 && $script_5 -eq 0 && $script_6 -eq 0 && $script_7 -eq 0 ]] && echo ::set-output name=status::success || echo ::set-output name=status::failure
- uses: actions/checkout@v4
- name: Check size script
id: size_checker
run: |
echo Checking size
code_line_number_1=$(wc -l < sh_tool/bin/nmb_operation.sh)
code_line_number_2=$(wc -l < sh_tool/bin/samba_manager.sh)
code_line_number_3=$(wc -l < sh_tool/bin/smb_info.sh)
code_line_number_4=$(wc -l < sh_tool/bin/smb_list.sh)
code_line_number_5=$(wc -l < sh_tool/bin/smb_operation.sh)
code_line_number_6=$(wc -l < sh_tool/bin/smb_version.sh)
code_line_number_7=$(wc -l < sh_tool/bin/winbind_operation.sh)
[[ $code_line_number_1 -gt 300 || $code_line_number_2 -gt 300 || $code_line_number_3 -gt 300 || $code_line_number_4 -gt 300 || $code_line_number_5 -gt 300 || $code_line_number_6 -gt 300 || $code_line_number_7 -gt 300 ]] && echo ::set-output name=status::failure || echo ::set-output name=status::success
- name: Check on failures
if: steps.syntax_checker.outputs.status == 'failure' || steps.size_checker.outputs.status == 'failure'
run: exit 1
modules_ok=0
modules=($(find sh_tool/ -type f -name '*.sh' -exec echo '{}' \;))
for mod in "${modules[@]}"; do line_numbers=$(wc -l < "${mod}"); [[ $line_numbers -gt 300 ]] && modules_ok=1; done
[[ $modules_ok -eq 0 ]] && echo ok || exit 1
4 changes: 2 additions & 2 deletions .github/workflows/samba_manager_toc.yml
@@ -1,8 +1,8 @@
name: samba_manager toc
name: samba_manager_toc
on: push
jobs:
generateTOC:
name: TOC Generator
runs-on: ubuntu-latest
steps:
- uses: technote-space/toc-generator@v2
- uses: technote-space/toc-generator@v4
8 changes: 4 additions & 4 deletions Dockerfile
@@ -1,4 +1,4 @@
# Copyright 2016 Vladimir Roncevic <elektron.ronca@gmail.com>
# Copyright 2016-2024 Vladimir Roncevic <elektron.ronca@gmail.com>
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand All @@ -13,7 +13,7 @@
# limitations under the License.
#

FROM debian:10
FROM debian:12
RUN apt-get update
RUN DEBIAN_FRONTEND=noninteractive \
apt-get install -yq --no-install-recommends \
Expand All @@ -25,8 +25,8 @@ RUN DEBIAN_FRONTEND=noninteractive \
openssl \
samba

RUN wget https://github.com/vroncevic/sh_util/archive/v1.0.zip
RUN unzip v1.0.zip
RUN wget https://github.com/vroncevic/sh_util/archive/1.0.zip
RUN unzip 1.0.zip
RUN find /sh_util-1.0/ -name "*.editorconfig" -type f -exec rm -Rf {} \;
RUN mkdir -p /root/scripts/sh_util/ver.1.0/
RUN cp -R /sh_util-1.0/sh_tool/bin/ /root/scripts/sh_util/ver.1.0/
Expand Down
27 changes: 14 additions & 13 deletions README.md
Expand Up @@ -6,7 +6,7 @@

Developed in **[bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell))** code: **100%**.

[![samba_manager shell checker](https://github.com/vroncevic/samba_manager/workflows/samba_manager%20shell%20checker/badge.svg)](https://github.com/vroncevic/samba_manager/actions?query=workflow%3A%22samba_manager+shell+checker%22)
[![samba_manager_shell_checker](https://github.com/vroncevic/samba_manager/actions/workflows/samba_manager_shell_checker.yml/badge.svg)](https://github.com/vroncevic/samba_manager/actions/workflows/samba_manager_shell_checker.yml)

The README is used to introduce the tool and provide instructions on
how to install the tool, any machine dependencies it may have and any
Expand Down Expand Up @@ -80,8 +80,6 @@ lrwxrwxrwx 1 root root 56 Nov 25 20:49 /root/bin/samba_manager -> /root/scripts/

Or You can use docker to create image/container.

[![samba_manager docker checker](https://github.com/vroncevic/samba_manager/workflows/samba_manager%20docker%20checker/badge.svg)](https://github.com/vroncevic/samba_manager/actions?query=workflow%3A%22samba_manager+docker+checker%22)

### Usage

```
Expand All @@ -100,13 +98,16 @@ Thu Nov 25 20:51:21 UTC 2021
[check_root] Check permission for current session? [ok]
[check_root] Done
_
___ __ _ _ __ ___ | |__ __ _ _ __ ___ __ _ _ __ __ _ __ _ ___ _ __
/ __|/ _` | '_ ` _ \| '_ \ / _` | | '_ ` _ \ / _` | '_ \ / _` |/ _` |/ _ \ '__|
\__ \ (_| | | | | | | |_) | (_| | | | | | | | (_| | | | | (_| | (_| | __/ |
|___/\__,_|_| |_| |_|_.__/ \__,_| |_| |_| |_|\__,_|_| |_|\__,_|\__, |\___|_|
|___/
██
░██ █████
██████ ██████ ██████████ ░██ ██████ ██████████ ██████ ███████ ██████ ██░░░██ █████ ██████
██░░░░ ░░░░░░██ ░░██░░██░░██░██████ ░░░░░░██ ░░██░░██░░██ ░░░░░░██ ░░██░░░██ ░░░░░░██ ░██ ░██ ██░░░██░░██░░█
░░█████ ███████ ░██ ░██ ░██░██░░░██ ███████ ░██ ░██ ░██ ███████ ░██ ░██ ███████ ░░██████░███████ ░██ ░
░░░░░██ ██░░░░██ ░██ ░██ ░██░██ ░██ ██░░░░██ ░██ ░██ ░██ ██░░░░██ ░██ ░██ ██░░░░██ ░░░░░██░██░░░░ ░██
██████ ░░████████ ███ ░██ ░██░██████ ░░████████ █████ ███ ░██ ░██░░████████ ███ ░██░░████████ █████ ░░██████░███
░░░░░░ ░░░░░░░░ ░░░ ░░ ░░ ░░░░░ ░░░░░░░░ ░░░░░ ░░░ ░░ ░░ ░░░░░░░░ ░░░ ░░ ░░░░░░░░ ░░░░░ ░░░░░░ ░░░
Info github.io/samba_manager ver.2.0
Issue github.io/issue
Expand Down Expand Up @@ -153,17 +154,17 @@ sh_tool/

### Docs

[![Documentation Status](https://readthedocs.org/projects/samba_manager/badge/?version=latest)](https://samba_manager.readthedocs.io/projects/samba_manager/en/latest/?badge=latest)
[![Documentation Status](https://readthedocs.org/projects/samba_manager/badge/?version=latest)](https://samba-manager.readthedocs.io/projects/samba_manager/en/latest/?badge=latest)

More documentation and info at
* [https://samba_manager.readthedocs.io/en/latest/](https://samba_manager.readthedocs.io/en/latest/)
* [https://samba_manager.readthedocs.io/en/latest/](https://samba-manager.readthedocs.io/en/latest/)
* [https://www.gnu.org/software/bash/manual/](https://www.gnu.org/software/bash/manual/)

### Copyright and licence

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

Copyright (C) 2016 by [vroncevic.github.io/samba_manager](https://vroncevic.github.io/samba_manager)
Copyright (C) 2016-2024 by [vroncevic.github.io/samba_manager](https://vroncevic.github.io/samba_manager)

**samba_manager** is free software; you can redistribute it and/or modify
it under the same terms as Bash itself, either Bash version 4.2.47 or,
Expand Down
Binary file modified docs/build/doctrees/environment.pickle
Binary file not shown.
Binary file modified docs/build/doctrees/index.doctree
Binary file not shown.
2 changes: 1 addition & 1 deletion docs/build/html/.buildinfo
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: a3396a558f4feb5fc9735ec94a628ffe
config: 4fe62c84791d1fef1a01540a5285c6d0
tags: 645f666f9bcd5a90fca523b33c5a78b7
13 changes: 4 additions & 9 deletions docs/build/html/_sources/index.rst.txt
Expand Up @@ -7,8 +7,8 @@ Developed in `bash <https://en.wikipedia.org/wiki/Bash_(Unix_shell)>`_ code: **1

|GitHub shell checker|

.. |GitHub shell checker| image:: https://github.com/vroncevic/samba_manager/workflows/samba_manager%20shell%20checker/badge.svg
:target: https://github.com/vroncevic/samba_manager/actions?query=workflow%3A%22samba_manager+shell+checker%22
.. |GitHub shell checker| image:: https://github.com/vroncevic/samba_manager/actions/workflows/samba_manager_shell_checker.yml/badge.svg
:target: https://github.com/vroncevic/samba_manager/actions/workflows/samba_manager_shell_checker.yml

The README is used to introduce the tool and provide instructions on
how to install the tool, any machine dependencies it may have and any
Expand All @@ -23,7 +23,7 @@ other information that should be provided before the tool is installed.
:target: https://github.com/vroncevic/samba_manager/graphs/contributors

.. |Documentation Status| image:: https://readthedocs.org/projects/samba_manager/badge/?version=latest
:target: https://samba_manager.readthedocs.io/projects/samba_manager/en/latest/?badge=latest
:target: https://samba-manager.readthedocs.io/projects/samba_manager/en/latest/?badge=latest

.. toctree::
:hidden:
Expand Down Expand Up @@ -54,11 +54,6 @@ To install **samba_manager** type the following
Or You can use Docker to create image/container.

|GitHub docker checker|

.. |GitHub docker checker| image:: https://github.com/vroncevic/samba_manager/workflows/samba_manager%20docker%20checker/badge.svg
:target: https://github.com/vroncevic/samba_manager/actions?query=workflow%3A%22samba_manager+docker+checker%22

Dependencies
-------------

Expand Down Expand Up @@ -104,7 +99,7 @@ Copyright and licence
.. |License: Apache 2.0| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
:target: https://opensource.org/licenses/Apache-2.0

Copyright (C) 2016 by `vroncevic.github.io/samba_manager <https://vroncevic.github.io/samba_manager>`_
Copyright (C) 2016-2024 by `vroncevic.github.io/samba_manager <https://vroncevic.github.io/samba_manager>`_

**samba_manager** is free software; you can redistribute it and/or modify it
under the same terms as Bash itself, either Bash version 4.2.47 or,
Expand Down
134 changes: 134 additions & 0 deletions docs/build/html/_static/_sphinx_javascript_frameworks_compat.js
@@ -0,0 +1,134 @@
/*
* _sphinx_javascript_frameworks_compat.js
* ~~~~~~~~~~
*
* Compatability shim for jQuery and underscores.js.
*
* WILL BE REMOVED IN Sphinx 6.0
* xref RemovedInSphinx60Warning
*
*/

/**
* select a different prefix for underscore
*/
$u = _.noConflict();


/**
* small helper function to urldecode strings
*
* See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL
*/
jQuery.urldecode = function(x) {
if (!x) {
return x
}
return decodeURIComponent(x.replace(/\+/g, ' '));
};

/**
* small helper function to urlencode strings
*/
jQuery.urlencode = encodeURIComponent;

/**
* This function returns the parsed url parameters of the
* current request. Multiple values per key are supported,
* it will always return arrays of strings for the value parts.
*/
jQuery.getQueryParameters = function(s) {
if (typeof s === 'undefined')
s = document.location.search;
var parts = s.substr(s.indexOf('?') + 1).split('&');
var result = {};
for (var i = 0; i < parts.length; i++) {
var tmp = parts[i].split('=', 2);
var key = jQuery.urldecode(tmp[0]);
var value = jQuery.urldecode(tmp[1]);
if (key in result)
result[key].push(value);
else
result[key] = [value];
}
return result;
};

/**
* highlight a given string on a jquery object by wrapping it in
* span elements with the given class name.
*/
jQuery.fn.highlightText = function(text, className) {
function highlight(node, addItems) {
if (node.nodeType === 3) {
var val = node.nodeValue;
var pos = val.toLowerCase().indexOf(text);
if (pos >= 0 &&
!jQuery(node.parentNode).hasClass(className) &&
!jQuery(node.parentNode).hasClass("nohighlight")) {
var span;
var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
if (isInSVG) {
span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
} else {
span = document.createElement("span");
span.className = className;
}
span.appendChild(document.createTextNode(val.substr(pos, text.length)));
node.parentNode.insertBefore(span, node.parentNode.insertBefore(
document.createTextNode(val.substr(pos + text.length)),
node.nextSibling));
node.nodeValue = val.substr(0, pos);
if (isInSVG) {
var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
var bbox = node.parentElement.getBBox();
rect.x.baseVal.value = bbox.x;
rect.y.baseVal.value = bbox.y;
rect.width.baseVal.value = bbox.width;
rect.height.baseVal.value = bbox.height;
rect.setAttribute('class', className);
addItems.push({
"parent": node.parentNode,
"target": rect});
}
}
}
else if (!jQuery(node).is("button, select, textarea")) {
jQuery.each(node.childNodes, function() {
highlight(this, addItems);
});
}
}
var addItems = [];
var result = this.each(function() {
highlight(this, addItems);
});
for (var i = 0; i < addItems.length; ++i) {
jQuery(addItems[i].parent).before(addItems[i].target);
}
return result;
};

/*
* backward compatibility for jQuery.browser
* This will be supported until firefox bug is fixed.
*/
if (!jQuery.browser) {
jQuery.uaMatch = function(ua) {
ua = ua.toLowerCase();

var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
/(webkit)[ \/]([\w.]+)/.exec(ua) ||
/(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
/(msie) ([\w.]+)/.exec(ua) ||
ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
[];

return {
browser: match[ 1 ] || "",
version: match[ 2 ] || "0"
};
};
jQuery.browser = {};
jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
}

0 comments on commit 0c2d13d

Please sign in to comment.