GoToSocial/internal/db/bundb/migrations
kim 33aee1b1e9
[chore] reformat GetAccount() functionality, support updating accounts based on last_fetch (#1411)
* reformat GetAccount() functionality, and add UpdateAccount() function.

* use fetched_at instead of last_webfingered_at

* catch local "not found" errors. small formatting / error string changes

* remove now unused error type

* return nil when wrapping nil error

* update expected error messages

* return correct url for foss satan webfinger

* add AP model for Some_User

* normalize local domain

* return notretrievable where appropriate

* expose NewErrNotRetrievable

* ensure webfinger for new accounts searched by uri

* update local account short circuit

* allow enrich to fail for already-known accounts

* remove unused LastWebfingeredAt

* expose test maps on mock http client

* update Update test

* reformat GetAccount() functionality, and add UpdateAccount() function.

* use fetched_at instead of last_webfingered_at

* catch local "not found" errors. small formatting / error string changes

* remove nil error checks (we shouldn't be passing nil errors to newError() initializers)

* remove mutex unlock on transport init fail (it hasn't yet been locked!)

* woops add back the error wrapping to use ErrNotRetrievable

* caches were never being started... 🙈

---------

Signed-off-by: kim <grufwub@gmail.com>
Co-authored-by: tsmethurst <tobi.smethurst@protonmail.com>
2023-02-03 20:03:05 +00:00
..
20211113114307_init [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220214175650_media_cleanup [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220315160814_admin_account_actions [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220905150505_custom_emoji_updates [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20211113114307_init.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220214175650_media_cleanup.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220305130328_database_optimizations.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220315160814_admin_account_actions.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220502113806_add_missing_indexes.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220506110822_add_account_raw_note.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220511165212_add_account_raw_note_fix.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220518123621_additional_indexing.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220612091800_duplicated_media_cleanup.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220710153020_fix_slow_web_profile_queries.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220804120132_account_default_post_format.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220823140228_user_custom_css.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220827085121_assign_missing_in_reply_to_uris.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220830014732_regenerate_indexes_for_follows.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220903141016_store_gifs_as_image.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220905150505_custom_emoji_updates.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220916122701_emojis_in_accounts.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220922142408_shared_inbox_delivery.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20220926115233_indexes.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20221006114842_add_rss_functionality.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20221011125732_refetch_updated_emojis.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20221031145649_emoji_categories.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20221103203553_add_external_id.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20221108142419_create_account_tombstones.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20221220134514_mp4_jiggery_pokery.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
20230105171144_report_model.go [feature] Implement Report database model and utility functions (#1310) 2023-01-10 14:19:05 +00:00
20230202212700_rename_account_webfingered_to_fetched.go [chore] reformat GetAccount() functionality, support updating accounts based on last_fetch (#1411) 2023-02-03 20:03:05 +00:00
README.md [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00
main.go [chore] Update/add license headers for 2023 (#1304) 2023-01-05 12:43:00 +01:00

README.md

Migrations

How do I write a migration file?

See here

As a template, take one of the existing migration files and modify it, or use the below code snippet:

/*
   GoToSocial
   Copyright (C) 2021-2023 GoToSocial Authors admin@gotosocial.org

   This program is free software: you can redistribute it and/or modify
   it under the terms of the GNU Affero 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 Affero General Public License for more details.

   You should have received a copy of the GNU Affero General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

package migrations

import (
    "context"

    "github.com/uptrace/bun"
)

func init() {
    up := func(ctx context.Context, db *bun.DB) error {
        return db.RunInTx(ctx, nil, func(ctx context.Context, tx bun.Tx) error {
            // your logic here
            return nil
        })
    }

    down := func(ctx context.Context, db *bun.DB) error {
        return db.RunInTx(ctx, nil, func(ctx context.Context, tx bun.Tx) error {
            // your logic here
            return nil
        })
    }

    if err := Migrations.Register(up, down); err != nil {
        panic(err)
    }
}

File format

Bun requires a very specific format: 14 digits, then letters or underscores.

You can use the following bash command on your branch to generate a suitable migration filename.

echo "$(date --utc +%Y%m%d%H%M%S | head -c 14)_$(git rev-parse --abbrev-ref HEAD).go"

Rules of thumb

  1. DON'T DROP TABLES!!!!!!!!
  2. Don't make something NOT NULL if it's likely to already contain null fields.