neocities-sync

Crates.ioneocities-sync
lib.rsneocities-sync
version
sourcesrc
created_at2024-06-25 09:39:18.956151+00
updated_at2025-03-10 18:22:46.791107+00
descriptionSync files to neocities while doing the least amount of API requests.
homepagehttps://github.com/aspizu/neocities-sync
repositoryhttps://github.com/aspizu/neocities-sync
max_upload_size
id1283161
Cargo.toml error:TOML parse error at line 17, column 1 | 17 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
(aspizu)

documentation

https://github.com/aspizu/neocities-sync

README

neocities-sync

Sync files to neocities while doing the least amount of API requests.

You can use this to deploy a Vite, Astro or Next.js app to neocities.

neocities-sync will:

  • Only upload files that have been modified.
  • Delete files which exist on neocities, but don't exist locally.
  • Store SHA1 hashes locally inside a .state file.
  • If the .state file doesn't exist, it will fetch all file hashes from neocities and store them in the .state file.
  • If --ignore-disallowed-file-types is set, it will ignore disallowed file types. Use this if you are NOT a supporter.

Installation

cargo install neocities-sync

Usage

❯ neocities-sync --help

|\---/|
| x_x |   neocities-sync
 \_-_/

Sync files to neocities while doing the least amount of API requests.

Usage: neocities-sync <COMMAND>

Commands:
  login   Login to neocities
  logout  Logout from neocities
  sync    Sync a directory to neocities
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

❯ neocities-sync sync --help

Sync a directory to neocities

Usage: neocities-sync.exe sync [OPTIONS] [PATH]

Arguments:
  [PATH]  The directory to sync [default: .]

Options:
  -u, --username <USERNAME>
  -s, --state <STATE>                 Path to the state file. Used to keep track of the last sync
  -i, --ignore-disallowed-file-types  Use this if you are NOT a supporter
  -h, --help                          Print help

Deploy a Vite/Astro/Next.js app to neocities

Run your build command. Given that your build output is in the dist directory, we can use neocities-sync to upload the files to neocities.

First login using the neocities-sync login command. It will prompt you for your username and password (Will not be displayed in the terminal)

❯ neocities-sync dist --ignore-disallowed-file-types --state .state

Here, we use --state .state to store the state outside the dist directory because it will be emptied on every build.

Now, every time you make changes to your app, re-run the build command and then run the neocities-sync command. It will only upload the files that have been modified.

Deploying to multiple accounts/sites.

Login to each of the accounts using neocities-sync login. The first account you log into is the default. Select a different account using the --username parameter, if not provided - the default account is selected.

For example, to sync to the account with username aspizu:

❯ neocities-sync --username aspizu dist --ignore-disallowed-file-types --state .state

You can log out of any account using logout, use the --username parameter to choose which account to log out.

Read the API KEY from an environment variable

You can set the NEOCITIES_API_KEY environment variable to your API key. --username will be ignored if the NEOCITIES_API_KEY environment variable is set.

Contributing

Pull requests are welcome.

Commit count: 18

cargo fmt