service

Documentation

Overview

Package service implements instagram account operations and business logic.

Package service implements instagram account operations and business logic.

Index

• Variables
• type Params
• type Service
  • func New(ctx context.Context, cfg config.Config, params Params) (*Service, error)
  • func (svc *Service) Follow(ctx context.Context, user models.User) error
  • func (svc *Service) FollowUsers(ctx context.Context, usernames []string) (int, error)
  • func (svc *Service) GetDiffFollowers(ctx context.Context) ([]models.UsersBatch, error)
  • func (svc *Service) GetDiffFollowings(ctx context.Context) ([]models.UsersBatch, error)
  • func (svc *Service) GetFollowers(ctx context.Context) ([]models.User, error)
  • func (svc *Service) GetFollowings(ctx context.Context) ([]models.User, error)
  • func (svc *Service) GetHistoryDiffFollowers(ctx context.Context) (models.DiffHistory, error)
  • func (svc *Service) GetHistoryDiffFollowings(ctx context.Context) (models.DiffHistory, error)
  • func (svc *Service) GetNotMutualFollowers(ctx context.Context) ([]models.User, error)
  • func (svc *Service) GetUselessFollowers(ctx context.Context) ([]models.User, error)
  • func (svc *Service) RemoveFollowersByUsername(ctx context.Context, usernames []string) (int, error)
  • func (svc *Service) Stop(ctx context.Context) error
  • func (svc *Service) UnFollow(ctx context.Context, user models.User) error
  • func (svc *Service) UnFollowAllNotMutualExceptWhitelisted(ctx context.Context) (int, error)
  • func (svc *Service) UnfollowUsers(ctx context.Context, usernames []string) (int, error)
  • func (svc *Service) UploadMedia(ctx context.Context, file io.Reader, mt media.Type) error
• type StopFunc

Variables

var (
	// ErrLimitExceed returned when limit for action exceeded.
	ErrLimitExceed = errors.New("limit exceeded")
	// ErrCorrupted returned when instagram returned error response more than one time during loop processing.
	ErrCorrupted = errors.New("unable to continue - instagram responses with errors")
	// ErrNoUsers means that no users found.
	ErrNoUsers = errors.New("no users")
	// ErrNoUsernamesPassed returns when usernames list is empty.
	ErrNoUsernamesPassed = errors.New("no usernames passed")
	// ErrUserInWhitelist means that user skipped.
	ErrUserInWhitelist = errors.New("user in whitelist")
	// ErrUserNotFound returned when user not found.
	ErrUserNotFound = errors.New("user not found")
)

Types

type Params

type Params struct {
	SessionPath string
	IsIncognito bool
	Username    string
}

Params holds Service constructor parameters.

type Service

type Service struct {
	// contains filtered or unexported fields
}

Service represents service for operating instagram account.

func New

func New(ctx context.Context, cfg config.Config, params Params) (*Service, error)

New creates new instance of Service instance and returns closure func that will stop service.

Usage: svc, err := New(context.Background(), config.Config{}, Params{}) if err != nil{ // handle error } defer svc.Stop().

func (*Service) Follow

func (svc *Service) Follow(ctx context.Context, user models.User) error

Follow adds user to followings.

func (*Service) FollowUsers

func (svc *Service) FollowUsers(ctx context.Context, usernames []string) (int, error)

FollowUsers follows users by the name passed.

func (*Service) GetDiffFollowers

func (svc *Service) GetDiffFollowers(ctx context.Context) ([]models.UsersBatch, error)

GetDiffFollowers returns batches with lost and new followers.

func (*Service) GetDiffFollowings

func (svc *Service) GetDiffFollowings(ctx context.Context) ([]models.UsersBatch, error)

GetDiffFollowings returns batches with lost and new followings.

func (*Service) GetFollowers

func (svc *Service) GetFollowers(ctx context.Context) ([]models.User, error)

GetFollowers returns list of followers for logged-in user.

func (*Service) GetFollowings

func (svc *Service) GetFollowings(ctx context.Context) ([]models.User, error)

GetFollowings returns list of followings for logged-in user.

func (*Service) GetHistoryDiffFollowers

func (svc *Service) GetHistoryDiffFollowers(ctx context.Context) (models.DiffHistory, error)

GetHistoryDiffFollowers returns diff history of followers for an account.

func (*Service) GetHistoryDiffFollowings

func (svc *Service) GetHistoryDiffFollowings(ctx context.Context) (models.DiffHistory, error)

GetHistoryDiffFollowings returns diff history of followings for an account.

func (*Service) GetNotMutualFollowers

func (svc *Service) GetNotMutualFollowers(ctx context.Context) ([]models.User, error)

GetNotMutualFollowers returns list of users that not following back.

func (*Service) GetUselessFollowers

func (svc *Service) GetUselessFollowers(ctx context.Context) ([]models.User, error)

GetUselessFollowers ranges all followers and tried to detect bots or business accounts. These accounts could be blocked as they are not useful for statistic.

func (*Service) RemoveFollowersByUsername

func (svc *Service) RemoveFollowersByUsername(ctx context.Context, usernames []string) (int, error)

RemoveFollowersByUsername removes all provided users by blocking and unblocking them to bypass Instagram limits.

func (*Service) Stop

func (svc *Service) Stop(ctx context.Context) error

Stop stops the service and closes clients connections.

func (*Service) UnFollow

func (svc *Service) UnFollow(ctx context.Context, user models.User) error

UnFollow removes user from followings.

func (*Service) UnFollowAllNotMutualExceptWhitelisted

func (svc *Service) UnFollowAllNotMutualExceptWhitelisted(ctx context.Context) (int, error)

UnFollowAllNotMutualExceptWhitelisted clean followings from users that not following back except of whitelisted users.

func (*Service) UnfollowUsers

func (svc *Service) UnfollowUsers(ctx context.Context, usernames []string) (int, error)

UnfollowUsers unfollows users by the name passed.

func (*Service) UploadMedia

func (svc *Service) UploadMedia(ctx context.Context, file io.Reader, mt media.Type) error

UploadMedia uploads media to profile.

type StopFunc

type StopFunc func() error

StopFunc closure func that will stop service.