nbagent


Namenbagent JSON
Version 1.0.1 PyPI version JSON
download
home_page
SummaryA Nullboard backup agent for Unix systems
upload_time2023-09-22 23:55:51
maintainer
docs_urlNone
author
requires_python>=3.6
license
keywords
VCS
bugtrack_url
requirements click Flask Flask-Cors
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # nbagent

`nbagent` is a [Nullboard](https://github.com/apankrat/nullboard) backup agent for Unix systems.

It works in the same way that the official [Nullboard Backup Agent](https://github.com/apankrat/nullboard-agent) for Windows.

## Installation

```sh
$ pip install nbagent
```

## Usage

Invoke `nbagent`:

```sh
$ nbagent
```

Immediately you'll see an output similar to this:

```sh
 * [i] Using data directory /Users/luis/.local/share/nbagent
 * [i] Config saved to /Users/luis/.local/share/nbagent/app-config.json
 * [!] Nullboard token: d6606ecaaae54612906cc56a75583b61
 * [i] Server listening 0.0.0.0:10001...
 ```

Note the line:

```
 * [!] Nullboard token: d6606ecaaae54612906cc56a75583b61
```

Just copy the auth token (in this example `d6606ecaaae54612906cc56a75583b61`) into Nullboard, [as per the instructions](https://nullboard.io/backups) and you're ready to go.

If for any reason you need to reset the auth token use:

 ```sh
$ nbagent --reset-token
```

You can also set a custom token if you want:

 ```sh
$ nbagent --override-token "123-456-789"
```

### Overriding defaults

`nbagent` allows you to specify several settings if you're not comfortable with the defaults.

> Note that `nbagent` don't use hardcoded paths for the data. It tries to use the standard directory `$XDG_DATA_HOME`. If not defined, it defaults to `$HOME/.local/share`.`

 ```sh
 $ nbagent --help

Usage: nbagent [OPTIONS]

  Start listening for Nullboard requests.

Options:
  --addr TEXT            Bind to address  [default: 0.0.0.0]
  --port INTEGER         Use custom port  [default: 10001]
  --data TEXT            Directory for data  [default: ~/.local/share/nbagent]
  --reset-token          Generate a new random auth token
  --override-token TEXT  Use a custom auth token
  --help                 Show this message and exit.
```

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "nbagent",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "",
    "author": "",
    "author_email": "Luis Medel <luis@luismedel.com>",
    "download_url": "https://files.pythonhosted.org/packages/ba/4b/14ddf1e8b12ee9e2734cdcf4a220e627a3c15b96cfafda41d9cf1ae3a8b5/nbagent-1.0.1.tar.gz",
    "platform": null,
    "description": "# nbagent\n\n`nbagent` is a [Nullboard](https://github.com/apankrat/nullboard) backup agent for Unix systems.\n\nIt works in the same way that the official [Nullboard Backup Agent](https://github.com/apankrat/nullboard-agent) for Windows.\n\n## Installation\n\n```sh\n$ pip install nbagent\n```\n\n## Usage\n\nInvoke `nbagent`:\n\n```sh\n$ nbagent\n```\n\nImmediately you'll see an output similar to this:\n\n```sh\n * [i] Using data directory /Users/luis/.local/share/nbagent\n * [i] Config saved to /Users/luis/.local/share/nbagent/app-config.json\n * [!] Nullboard token: d6606ecaaae54612906cc56a75583b61\n * [i] Server listening 0.0.0.0:10001...\n ```\n\nNote the line:\n\n```\n * [!] Nullboard token: d6606ecaaae54612906cc56a75583b61\n```\n\nJust copy the auth token (in this example `d6606ecaaae54612906cc56a75583b61`) into Nullboard, [as per the instructions](https://nullboard.io/backups) and you're ready to go.\n\nIf for any reason you need to reset the auth token use:\n\n ```sh\n$ nbagent --reset-token\n```\n\nYou can also set a custom token if you want:\n\n ```sh\n$ nbagent --override-token \"123-456-789\"\n```\n\n### Overriding defaults\n\n`nbagent` allows you to specify several settings if you're not comfortable with the defaults.\n\n> Note that `nbagent` don't use hardcoded paths for the data. It tries to use the standard directory `$XDG_DATA_HOME`. If not defined, it defaults to `$HOME/.local/share`.`\n\n ```sh\n $ nbagent --help\n\nUsage: nbagent [OPTIONS]\n\n  Start listening for Nullboard requests.\n\nOptions:\n  --addr TEXT            Bind to address  [default: 0.0.0.0]\n  --port INTEGER         Use custom port  [default: 10001]\n  --data TEXT            Directory for data  [default: ~/.local/share/nbagent]\n  --reset-token          Generate a new random auth token\n  --override-token TEXT  Use a custom auth token\n  --help                 Show this message and exit.\n```\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "A Nullboard backup agent for Unix systems",
    "version": "1.0.1",
    "project_urls": {
        "Homepage": "https://github.com/luismedel/nbagent"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d0dd9e9792f5ccfc12f931972eb4e3363d7d2d10ad0a7bc01c25ba39ad31ec58",
                "md5": "a66cdf1c20c9af829dc8c42f6e769633",
                "sha256": "64ac520c13f55c01c9507ed0f3794fd56a765eeed627793ebbecc920d8f384ad"
            },
            "downloads": -1,
            "filename": "nbagent-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a66cdf1c20c9af829dc8c42f6e769633",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 5528,
            "upload_time": "2023-09-22T23:55:49",
            "upload_time_iso_8601": "2023-09-22T23:55:49.979423Z",
            "url": "https://files.pythonhosted.org/packages/d0/dd/9e9792f5ccfc12f931972eb4e3363d7d2d10ad0a7bc01c25ba39ad31ec58/nbagent-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba4b14ddf1e8b12ee9e2734cdcf4a220e627a3c15b96cfafda41d9cf1ae3a8b5",
                "md5": "83b9379f6a80e7fb2001c5c366a105eb",
                "sha256": "1287302207145fd4a72c593739c3c17a5e5fec6bda3b05073b933290bf80a4d0"
            },
            "downloads": -1,
            "filename": "nbagent-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "83b9379f6a80e7fb2001c5c366a105eb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 5001,
            "upload_time": "2023-09-22T23:55:51",
            "upload_time_iso_8601": "2023-09-22T23:55:51.497382Z",
            "url": "https://files.pythonhosted.org/packages/ba/4b/14ddf1e8b12ee9e2734cdcf4a220e627a3c15b96cfafda41d9cf1ae3a8b5/nbagent-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-22 23:55:51",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "luismedel",
    "github_project": "nbagent",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "click",
            "specs": [
                [
                    "==",
                    "8.1.7"
                ]
            ]
        },
        {
            "name": "Flask",
            "specs": [
                [
                    "==",
                    "2.3.3"
                ]
            ]
        },
        {
            "name": "Flask-Cors",
            "specs": [
                [
                    "==",
                    "4.0.0"
                ]
            ]
        }
    ],
    "lcname": "nbagent"
}
        
Elapsed time: 0.25210s