Forem: Alexandre Freire

Tipos de Case na Programação: Como Escolher o Melhor para seu Código

Alexandre Freire — Mon, 17 Feb 2025 01:13:23 +0000

Se você é programador, provavelmente já se deparou com diferentes estilos de escrita para nomear variáveis, funções e classes. Esses padrões são chamados de naming case e desempenham um papel fundamental na legibilidade e padronização do código.

Vamos explorar os principais tipos de case usados na programação, quando utilizá-los e como escolher o melhor para seu projeto.

O que são Naming Cases?

Os naming cases são convenções de nomenclatura usadas para formatar nomes de variáveis, funções, classes e constantes. Seguir um padrão adequado melhora a organização do código e facilita a colaboração em equipe.

A seguir, veremos os estilos mais comuns e suas aplicações.

1. camelCase

📌 Descrição: As palavras são unidas sem separadores, e a primeira letra da primeira palavra é minúscula, enquanto as demais iniciam com maiúscula.

📌 Uso Comum: Variáveis e funções em linguagens como JavaScript, Java, TypeScript e Swift.

📌 Exemplo:

let nomeUsuario = "João";  
function calcularTotalCompra() { /* código */ }

✅ Vantagens:

Muito usado em linguagens populares.
Fácil de ler quando há poucas palavras.
Evita caracteres especiais, tornando o código mais limpo.

❌ Desvantagens:

Pode ser difícil de ler em nomes muito longos.

2. PascalCase

📌 Descrição: Similar ao camelCase, mas a primeira letra também é maiúscula.

📌 Uso Comum: Nome de classes, componentes em React e .NET.

📌 Exemplo:

class UsuarioCadastro { /* código */ }

✅ Vantagens:

Padrão recomendado para classes e objetos.
Fácil de identificar elementos de alto nível no código.

❌ Desvantagens:

Pode ser confundido com camelCase se não houver um padrão bem definido no projeto.

3. snake_case

📌 Descrição: As palavras são separadas por underscores (_) e todas as letras são minúsculas.

📌 Uso Comum: Python, bancos de dados (SQL) e algumas configurações de arquivos.

📌 Exemplo:

nome_usuario = "João"  
def calcular_total_compra():  
    # código

✅ Vantagens:

Excelente legibilidade, especialmente para nomes longos.
Muito usado em linguagens como Python e SQL.

❌ Desvantagens:

Em muitas linguagens modernas (JavaScript, Java, C#, Swift), o uso do snake_case foge do padrão adotado pela comunidade, o que pode prejudicar a padronização do código.

4. SCREAMING_SNAKE_CASE

📌 Descrição: Uma variação do snake_case, mas todas as letras são maiúsculas.

📌 Uso Comum: Nomenclatura de constantes em diversas linguagens.

📌 Exemplo:

#define TAMANHO_MAXIMO 100  
const MAX_USERS = 500;

✅ Vantagens:

Fácil de identificar constantes no código.
Padrão adotado na maioria das linguagens.

❌ Desvantagens:

Não indicado para variáveis comuns, pois dificulta a leitura.

5. kebab-case

📌 Descrição: As palavras são separadas por traços (-) e todas as letras são minúsculas.

📌 Uso Comum: Nomes de arquivos, URLs e algumas configurações de frameworks web.

📌 Exemplo:

minha-variavel  
https://meusite.com/pagina-inicial

✅ Vantagens:

Padrão ideal para URLs e arquivos.
Amplamente utilizado no desenvolvimento web.

❌ Desvantagens:

Não pode ser usado em variáveis de código-fonte, pois o hífen é interpretado como um operador de subtração.

Qual Naming Case Usar no Seu Projeto?

A escolha do naming case depende da linguagem e das convenções do time. Aqui estão algumas recomendações gerais:

🔹 JavaScript, Java, Swift → Use camelCase para variáveis e funções.
🔹 C#, React, .NET → Use PascalCase para classes e componentes.
🔹 Python, SQL → Prefira snake_case para variáveis e nomes de tabelas.
🔹 Constantes em qualquer linguagem → Use SCREAMING_SNAKE_CASE.
🔹 Nomes de arquivos e URLs → Utilize kebab-case.

Escolher a convenção certa para nomear variáveis e funções ajuda a manter um código limpo e organizado. Além disso, seguir um padrão melhora a colaboração entre desenvolvedores e evita erros de interpretação.

Agora que você conhece os principais naming cases, qual deles você mais usa? Deixe seu comentário abaixo! 👇💬

Sites that offer free certifications

Alexandre Freire — Thu, 08 Dec 2022 15:23:18 +0000

There are many websites that offer free certifications, often in the form of online courses or tutorials that users can complete to demonstrate their knowledge and skills in a particular subject. Some examples of websites that offer free certifications include:

Coursera: Coursera offers thousands of online courses in a wide range of subjects, many of which are free to take. Some courses also offer the option to purchase a paid certificate to verify completion of the course.

Khan Academy: Khan Academy offers free online courses and tutorials in subjects such as math, science, and history. While the courses do not offer formal certifications, users can earn badges and points to track their progress and achievements.

edX: edX is a nonprofit online learning platform that offers free courses and tutorials from top universities and institutions. Many courses offer the option to purchase a paid certificate to verify completion.

Udacity: Udacity offers free and paid online courses in subjects such as computer science, data science, and business. Some free courses offer a certificate of completion, while others require a paid subscription to access the certificate.

LinkedIn Learning: LinkedIn Learning (formerly Lynda.com) offers a wide range of online courses and tutorials, many of which are free to access. Some courses offer a certificate of completion for a fee, while others do not offer a certificate.

Overall, there are many websites that offer free certifications in various subjects, which can be a valuable resource for those looking to learn new skills and advance their careers. It's important to carefully research and compare different options to find the right fit for your needs and goals.

Video Tutorial CapRover

Alexandre Freire — Wed, 02 Mar 2022 19:58:13 +0000

Get $100 credits free to test Digital Ocean Services

See also the full post talking about caprover:

The best free alternative to Heroku

Alexandre Freire ・ Feb 13 '22

#heroku #webdev

GitHub

caprover / caprover

Scalable PaaS (automated Docker+nginx) - aka Heroku on Steroids

CapRover

Easiest app/database deployment platform and webserver package for your NodeJS, Python, PHP, Ruby, Go applications.

No Docker, nginx knowledge required!

What's this?

CapRover is an extremely easy to use app/database deployment & web server manager for your NodeJS, Python, PHP, ASP.NET, Ruby, MariaDB, MySQL, MongoDB, Postgres, WordPress (and etc...) applications!

It's blazingly fast and very robust as it uses Docker, nginx, LetsEncrypt and NetData under the hood behind its simple-to-use interface.

✔ CLI for automation and scripting

✔ Web GUI for ease of access and convenience

✔ No lock-in! Remove CapRover and your apps keep working!

✔ Docker Swarm under the hood for containerization and clustering

✔ Nginx (fully customizable template) under the hood for load-balancing

✔ Let's Encrypt under the hood for free SSL (HTTPS)

Seriously! Who should care about CapRover?

A [web] developer who does not like spending hours and days setting up a server, build tools…

View on GitHub

The best free alternative to Heroku

Alexandre Freire — Sun, 13 Feb 2022 16:09:10 +0000

I recently discovered a new tool, I was looking for an alternative that came closest to Heroku. Personally I think Heroku is very good, but very expensive, I know it's not a simple VPS, plus $7 for me who live in Brazil is a high value, I'm referring to the hobby plan where it's possible to add a domain with SSL, and prevent the application from 'sleeping'.

So now Caprover is my equivalent alternative to Heroku, I have full control over the infrastructure and I don't need technical knowledge to manage it. With a VPS of only $5 I can now upload my apps with the right to a custom domain with SSL without paying anything extra for it.

Currently my VPS is 1gb of ram, it is 65% used, but it already has 5 active applications in .net core, and a Mysql server with 3 databases. In other words, there is still room for me to put more in this current structure.

And if I need to, I can easily scale with the facilities offered by CapRover. Now I will leave here an overview talking about CapRover, remembering that I took this text from the documentation.

What's CapRover?

CapRover is an extremely easy to use app/database deployment & web server manager for your NodeJS, Python, PHP, ASP.NET, Ruby, MySQL, MongoDB, Postgres, WordPress (and etc...) applications!

It's blazingly fast and very robust as it uses Docker, nginx, LetsEncrypt and NetData under the hood behind its simple-to-use interface.

✔ CLI for automation and scripting
✔ Web GUI for ease of access and convenience
✔ No lock-in! Remove CapRover and your apps keep working!
✔ Docker Swarm under the hood for containerization and clustering
✔ Nginx (fully customizable template) under the hood for load-balancing
✔ Let's Encrypt under the hood for free SSL (HTTPS)

It's made for a developer who...

does not like spending hours and days setting up a server, build tools, sending code to server, build it, get an SSL certificate, install it, update nginx over and over again.

uses expensive services like Heroku, Microsoft Azure and etc. And is interested in reducing their cost by 4x (Heroku charges 25$/month for their 1gb instance, the same server is 5$ on DigitalOcean!!)

prefers to write more of showResults(getUserList()) and not much of apt-get install libstdc++6 > /dev/null

enjoys a platform where installing MySQL, MongoDB and etc on their server is done by selecting from a dropdown and clicking on install!

likes to enjoy the power of Docker and nginx without having to learn them or deal with their settings scripts to make things work!!

knows Docker and nginx inside out, and enjoys a platform where basic operations are done, yet allowing them to customize any specific settings if they need to

Any Language
Deploy apps in your own space (Node js, PHP, Python, Java literally any language!)

SSL
Ability to secure your services over HTTPS for FREE, ability to automatically redirect HTTP to HTTPS.

One-Click Apps
Deploying one-click apps is a matter of seconds! MongoDB, Parse, MySQL, WordPress, Postgres and many more.

Easy Deploy
Many ways to deploy: upload your source from dashboard, use command line caprover deploy, use webhooks and build upon git push

Simple Interface
Simple interface for many docker operations: exposing container ports to host, setting up persistent directories, instance count and etc.

Fully Customizable
Optionally fully customizable nginx config allowing you to enable HTTP2, specific caching logic, custom SSL certs and etc.

Cluster Ready
Attach more nodes and create a cluster in seconds! CapRover automatically configures nginx to load balance.

Increase Productivity
Focus on your apps! Not the bells and whistles just to run your apps!

To finish

You can use CapRover with any cloud provider like AWS, Azure, Google Cloud or other. But CapRover is already available too on the ocean digital store, that is, you will not even need to configure it, just choose it, inform your VPS configuration, datacenter and finally create, after that you will receive the fixed public IP of your VPS and the details to access the CapRover dashboard.

I will leave here a link promoting Digital Ocean, using my link you receive $100 free to test the platform.
Get $100 credits free to test Digital Ocean Services

YouTube Tutorial
GitHub Repo
Docs

Como liberar acesso remoto do MySql server no Ubuntu

Alexandre Freire — Tue, 01 Feb 2022 12:41:58 +0000

Config file changes are required to enable connections via localhost.

To connect through remote IPs, Login as a "root" user and run the below queries in mysql.


CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';

GRANT ALL PRIVILEGES ON *.* TO 'username'@'localhost' WITH GRANT OPTION;

CREATE USER 'username'@'%' IDENTIFIED BY 'password';

GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' WITH GRANT OPTION;

FLUSH PRIVILEGES;

This will create a new user that is accessible on localhost as well as from remote IPs.

Also comment the below line from your my.cnf file located in /etc/mysql/my.cnf

bind-address = 127.0.0.1

Restart your mysql using

sudo service mysql restart

Now you should be able to connect remotely to your mysql.

Solution found on stackoverflow and written by harishannam

WhatsApp Custom Link Message

Alexandre Freire — Wed, 05 Jan 2022 16:39:04 +0000

Make custom link messages to Whatsapp with nuget package.

var waComposer = new WaComposer();
waComposer.WriteText("Pedido",1,1);
//Observation: this 1,1 is break line. 1 before and 1 after

waComposer.WriteText("Item One");

//can format - available options: Italic, Bold, Strikethrough, Monospace.
waComposer.WriteText(WaFormat.Bold("Two")); 
waComposer.WriteText(WaFormat.Italic("Example Number: ") + "3");

var textResult = waComposer.GetText();

var whatsAppLink = WaSender.GetLink("PHONE_NUMBER_HERE",textResult);

//example output of whatsAppLink 
"https://wa.me/123/?text=THE_MESSAGE_FORMATED_BY_PACKAGE_HERE"
or on mobile 
"whatsapp://send?text=THE_MESSAGE_FORMATED_BY_PACKAGE_HERE&phone=123"

being able to stay like this for example:

Available on https://www.nuget.org/packages/WhatsAppLink/
Github https://github.com/oalexandrefreire/WhatsAppLinkCSharp

List of Web Attacks

Alexandre Freire — Tue, 28 Dec 2021 12:56:16 +0000

This is a list of some types of attacks. The list is incomplete, the idea is to feed it based on your and other people's comments. If you know of any attacks that are not on the list or have already suffered from a comment here.

There are many interesting stories and I'm sure it will serve as a warning for other people not to go through the same, I've suffered some attacks when I created a VPS, because I didn't worry about security the intruder broke in and was using my VPS to mine bitcoins.

SpreadArray CSharp

Alexandre Freire — Mon, 11 Oct 2021 12:39:22 +0000

I decided to publish an extension that simulates a javascript spread function.

When I started using c # I missed some features that I used in javascript, I know they are different things and that c # is a strongly typed language.

But I'll leave the link to the package that I created and use in some projects, and that solves some problems.

Spread Array CSharp

The spread operator is denoted by three dots (…)(popular in javascript). · The spread operator unpacks elements of iterable objects such as arrays, sets, and maps into a list.

Example

var user = new User("Alexandre");
var userAddress = new UserAddress("Porto Velho", "Brasil");
var contact = new Contact("my@mail.com");

dynamic dynamicUserProfile = new ExpandoObject();
dynamicUserProfile = user.Spread(userAddress).Spread(contact);

/// Example 1: preparing to json response
JObject json = JObject.FromObject(new { dynamicUserProfile });

/// Example 2: setting value on richTextBox from windows application
richTextBox1.Text = json.SelectToken("dynamicUserProfile").ToString();

    public class UserAddress
    {
        public UserAddress(string city, string country)
        {
            City = city;
            Country = country;
        }

        public string City { get; set; }
        public string Country { get; set; }
    }

    public class User
    {
        public User(string name)
        {
            Name = name;
        }

        public string Name { get; set; }
    }

    public class Contact
    {
        public Contact(string email)
        {
            Email = email;
        }

        public string Email { get; set; }
    }

Plano de estudos em machine learning com conteúdos em português.

Alexandre Freire — Wed, 18 Aug 2021 21:07:37 +0000

By https://github.com/italojs/awesome-machine-learning-portugues

Alfinetada/lembrete

Fulano(a), sei que não é fácil aprender inglês, mas só queria lembrar que você está perdendo MUITO conteúdo em não focar nessa língua, você perde muito conteúdo e os assuntos que não consegue estudar em inglês, muito provavelmente são assuntos atrasados, se você estudasse tudo isso em inglês veria o quádruplo de contéudo. Não quero que você pare de estudar machine learning (programação em geral na verdade), mas olha, começe a se cobrar um pouco mais nese ponto 😉

Agora vamos estudar machine learning até o talo! 👊

Por que usar?

Muito das pessoas que querem entra no mundo de machine learning começam pelo mais avançado que há, redes neurais com algum framwork(tensorflow, CNTK, pytorch e etc), mas antes de chegar em redes neurais é importante que você passe por outros assuntos mais básicos para então chegar a desenvolver uma rede neural de fato, ou pelo menos entender o que você está fazendo.

Aqui você encontrará um lista já pronta de assunos a serem estudados, tudo na ordem correta, assim você não terá de gastar tempo aprendendo a aprender machine learning.

Posso aprender e arrumar um emprego em Machine Learning sem estudar mestrado e Phd em Ciência da Computação?
- "Você pode, mas isto é muito mais difícil do que quando eu entrei no campo." Drac Smith
Como eu consigo um emprego em Machine Learning como um programador de software que auto-estudou Machine Learning, mas nunca teve a chance de usar isso no trabalho?
- "Estou contratando especialistas de Machine Learning para minha equipe e seu MOOC não vai conseguir para você o trabalho (há melhores notícias abaixo). Na verdade, muitas pessoas com um mestrado em Machine Learning não terão o emprego porque eles (e a maioria que tomaram MOOC) não têm uma compreensão profunda que vai me ajudar a resolver os meus problemas." Ross C. Taylor
Que habilidades são necessárias para trabalhos de Machine Learning?
- "Primeiramente, você precisa ter um decente background de Ciência da Computação/Matemática. ML é um tópico avançado, então a maioria dos livros didáticos assumem que você tem esse background. Por segundo, Machine Learning é um tema muito geral com várias sub especialidades que exigem habilidades únicas. Você pode querer procurar o currículo de um programa de MS em Machine Learning para ver o curso, o currículo e livro didático." Uri
- "Estatística, propabilidade, computação distribuída e estatística." Hydrangea

Eu me encontro em tempos difíceis.

AFAIK, Há dois lados para Machine Learning:

Prática de Machine Learning: Isto é sobre bancos de dados de consultas, limpeza de dados, escrevendo scripts para transformar dados e colagem de algoritmo e bibliotecas juntos e escrever código personalizado para espremer respostas confiáveis de dados para satisfazer as perguntas difíceis e mal definidas. É a porcaria da realidade.
Teoria de Machine Learning: Isto é sobre matemática e abstração e cenários idealizados e limites e beleza e informando o que é possível. É muito mais puro e mais limpo e removido da confusão da realidade.

Eu acho que a melhor maneira para metodologia centrada na prática é algo como 'prática - aprendizagem - prática', que significa onde estudantes primeiro vêm com alguns projetos existentes com problemas e soluções (prática) para se familiarizar com os métodos tradicionais na área e talvez também com sua metodologia.Depois de praticar com algumas experiências elementares, podem ir para os livros e estudar a teoria subjacente, que serve para guiar a sua futura prática avançada e reforçará a sua caixa de ferramentas de solução de problemas práticos. Estudar a teoria também melhora ainda mais sua compreensão sobre as experiências elementares e irá ajudá-los a adquirir experiências avançadas mais rapidamente.

É um plano longo. Isso vai demorar anos para mim. Se você já está familiarizado com bastante disso já, você levará muito menos tempo.

Como usar?

Tudo abaixo é uma estrutura de tópicos, e você deve enfrentar os itens em ordem de cima para baixo.
Não precisa ver todos os links, mas você tem que entender cada um dos tópicos.

Não sinta que não é inteligente o bastante

Para aprender machine learning, você terá de aprender matemática, mas não se preocupe, não é tão difícil quanto parece, caso você discorde de mim, leia esse artigo

Assuntos introdutórios

classificação vs predição

Machine Learning Supervisionado

Árvore de Decisão

KNN - K-Vizinhos Mais Próximos (K-Nearest Neighbors)

Naive Bayes

SVM - Máquina de Vetores de Suporte (Support Vector Machine)

Regressão Linear

Regressão Multivariada

Implementação em Python

Regressão Polinomial

Implementação em Python

Perceptron

Regressão Logística

Função de Custo

Gradiente Descendente (Gradient Descent)

Multilayer Perceptron

Redes Neurais, Perceptron Multicamadas e o Algoritmo Backpropagation

Redes Neurais Convolucionais

## Adaboost

Rede Neurais Recorrentes

Machine Learning Não-Supervisionado

PCA - Análise de Componentes Principais (Principal Component Analysis)

Implementação em Python

LDA - Análise Discriminante Linear (Linear Discriminant Analysis)

Implementação em Python

K-Médias (K-Means)

Implementação em Python

Secure localStorage data with high level of encryption and data compression

Alexandre Freire — Wed, 18 Aug 2021 21:03:32 +0000

By https://github.com/softvar/secure-ls

secure-ls

Secure localStorage data with high level of encryption and data compression.

LIVE DEMO

Features

Secure data with various types of encryption including AES, DES, Rabbit and RC4. (defaults to Base64 encoding).
Compress data before storing it to localStorage to save extra bytes (defaults to true).
Advanced API wrapper over localStorage API, providing other basic utilities.
Save data in multiple keys inside localStorage and secure-ls will always remember it's creation.

Installation

$ npm install secure-ls

Libraries used

Encryption / Decryption using The Cipher Algorithms

It requires secret-key for encrypting and decrypting data securely. If custom secret-key is provided as mentioned below in APIs, then the library will pick that otherwise it will generate yet another very secure unique password key using PBKDF2, which will be further used for future API requests.

PBKDF2 is a password-based key derivation function. In many applications of cryptography, user security is ultimately dependent on a password, and because a password usually can't be used directly as a cryptographic key, some processing is required.

A salt provides a large set of keys for any given password, and an iteration count increases the cost of producing keys from a password, thereby also increasing the difficulty of attack.

Eg: 55e8f5585789191d350329b9ebcf2b11 and db51d35aad96610683d5a40a70b20c39.

For the generation of such strings, secretPhrase is being used and can be found in code easily but that won't make it unsecure, PBKDF2's layer on top of that will handle security.

Compresion / Decompression using lz-string

Usage

Example 1: With default settings i.e. Base64 Encoding and Data Compression

> var ls = new SecureLS();
> ls.set('key1', {data: 'test'}); // set key1
> ls.get('key1'); // print data
  {data: 'test'}

Example 2: With AES Encryption and Data Compression

> var ls = new SecureLS({encodingType: 'aes'});
> ls.set('key1', {data: 'test'}); // set key1
> ls.get('key1'); // print data
  {data: 'test'}

> ls.set('key2', [1, 2, 3]); // set another key
> ls.getAllKeys(); // get all keys
  ["key1", "key2"]
> ls.removeAll(); // remove all keys

Example 3: With RC4 Encryption but no Data Compression

> var ls = new SecureLS({encodingType: 'rc4', isCompression: false});
> ls.set('key1', {data: 'test'}); // set key1
> ls.get('key1'); // print data
  {data: 'test'}

> ls.set('key2', [1, 2, 3]); // set another key
> ls.getAllKeys(); // get all keys
  ["key1", "key2"]
> ls.removeAll(); // remove all keys

Example 3: With DES Encryption, no Data Compression and custom secret key

> var ls = new SecureLS({encodingType: 'des', isCompression: false, encryptionSecret: 'my-secret-key'});
> ls.set('key1', {data: 'test'}); // set key1
> ls.get('key1'); // print data
  {data: 'test'}

> ls.set('key2', [1, 2, 3]); // set another key
> ls.getAllKeys(); // get all keys
  ["key1", "key2"]
> ls.removeAll(); // remove all keys

API Documentation

Create an instance / reference before using.

var ls = new SecureLS();

Contructor accepts a configurable Object with all three keys being optional.

Config Keys	default	accepts
encodingType	Base64	`base64`/`aes`/`des`/`rabbit`/`rc4`/`''`
isCompression	`true`	`true`/`false`
encryptionSecret	PBKDF2 value	String
encryptionNamespace	null	String

Note: encryptionSecret will only be used for the Encryption and Decryption of data
with AES, DES, RC4, RABBIT, and the library will discard it if no encoding / Base64
encoding method is choosen.

encryptionNamespace is used to make multiple instances with different encryptionSecret
and/or different encryptionSecret possible.

var ls1 = new SecureLS({encodingType: 'des', encryptionSecret: 'my-secret-key-1'});
var ls2 = new SecureLS({encodingType: 'aes', encryptionSecret: 'my-secret-key-2'});

Examples:

No config or empty Object i.e. Default Base64 Encoding and Data compression

var ls = new SecureLS();
// or
var ls = new SecureLS({});

No encoding No data compression i.e. Normal way of storing data

var ls = new SecureLS({encodingType: '', isCompression: false});

Base64 encoding but no data compression

var ls = new SecureLS({isCompression: false});

AES encryption and data compression

var ls = new SecureLS({encodingType: 'aes'});

RC4 encryption and no data compression

var ls = new SecureLS({encodingType: 'rc4', isCompression: false});

RABBIT encryption, no data compression and custom encryptionSecret

var ls = new SecureLS({encodingType: 'rc4', isCompression: false, encryptionSecret: 's3cr3tPa$$w0rd@123'});

Methods

set

Saves data in specifed key in localStorage. If the key is not provided, the library will warn. Following types of JavaScript objects are supported:

Array
ArrayBuffer
Blob
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Number
Object
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array
String

| Parameter | Description |
| ------------- | --------------------------- |
| key | key to store data in |
| data | data to be stored |

    ls.set('key-name', {test: 'secure-ls'})

get

Gets data back from specified key from the localStorage library. If the key is not provided, the library will warn.

| Parameter | Description |
| ------------- | ----------------------------------- |
| key | key in which data is stored |

    ls.get('key-name')

remove

Removes the value of a key from the localStorage. If the meta key, which stores the list of keys, is tried to be removed even if there are other keys which were created by secure-ls library, the library will warn for the action.

| Parameter | Description |
| ------------- | ----------------------------------------- |
| key | remove key in which data is stored |

    ls.remove('key-name')

removeAll

Removes all the keys that were created by the secure-ls library, even the meta key.

    ls.removeAll()

clear

Removes all the keys ever created for that particular domain. Remember localStorage works differently for http and https protocol;

    ls.clear()

getAllKeys

Gets the list of keys that were created using the secure-ls library. Helpful when data needs to be retrieved for all the keys or when keys name are not known(dynamically created keys).

getAllKeys()

    ls.getAllKeys()

Screenshot

Scripts

npm run build - produces production version of the library under the dist folder
npm run dev - produces development version of the library and runs a watcher
npm run test - well ... it runs the tests :)

Contributing

Fork the repo on GitHub.
Clone the repo on machine.
Execute npm install and npm run dev.
Create a new branch <fix-typo> and do your work.
Run npm run build to build dist files and npm run test to ensure all test cases are passing.
Commit your changes to the branch.
Submit a Pull request.

Development Stack

Webpack based src compilation & bundling and dist generation.
ES6 as a source of writing code.
Exports in a umd format so the library works everywhere.
ES6 test setup with Mocha and Chai.
Linting with ESLint.

Process

ES6 source files
       |
       |
    webpack
       |
       +--- babel, eslint
       |
  ready to use
     library
  in umd format

Credits

Many thanks to:

@brix for the awesome crypto-js library for encrypting and decrypting data securely.
@pieroxy for the lz-string js library for data compression / decompression.
@chinchang for the below open-source libraries which are used only for the Landing Page Development.
- screenlog.js - Brings console.log on the page's screen.
- superplaceholder.js - For super charging input placeholders.

Copyright and license

The MIT license (MIT)

Copyright (c) 2015-2016 Varun Malhotra

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

PHPloy - incremental Git FTP and SFTP deployment tool

Alexandre Freire — Wed, 18 Aug 2021 21:01:43 +0000

PHPloy

Version 4.9.2

PHPloy is an incremental Git FTP and SFTP deployment tool. By keeping track of the state of the remote server(s) it deploys only the files that were committed since the last deployment. PHPloy supports submodules, sub-submodules, deploying to multiple servers and rollbacks. PHPloy requires PHP 7.0+ and Git 1.8+.

How it works

PHPloy stores a file called .revision on your server. This file contains the hash of the commit that you have deployed to that server. When you run phploy, it downloads that file and compares the commit reference in it with the commit you are trying to deploy to find out which files to upload. PHPloy also stores a .revision file for each submodule in your repository.

Install

Via Composer

If you have composer installed in your machine, you can pull PHPloy globally like this:

composer global require "banago/phploy"

Make sure to place the $HOME/.composer/vendor/bin directory (or the equivalent directory for your OS)
in your $PATH so the PHPloy executable can be located by your system.

Via Phar Archive

You can install PHPloy Phar globally, in your /usr/local/bin directory or, locally, in your project directory. Rename phploy.phar to phploy for ease of use.

Globally: Move phploy into /usr/local/bin. Make it executable by running sudo chmod +x phploy.
Locally Move phploy into your project directory.

Usage

When using PHPloy locally, proceed the command with php

Run phploy --init in the terminal to create the phploy.ini file or create one manually.
Run phploy in terminal to deploy.

Windows Users: Installing PHPloy globally on Windows

phploy.ini

The phploy.ini file holds your project configuration. It should be located in the root directory of the project. phploy.ini is never uploaded to server. Check the sample below for all available options:

; This is a sample deploy.ini file. You can specify as many
; servers as you need and use normal or quickmode configuration.
;
; NOTE: If a value in the .ini file contains any non-alphanumeric 
; characters it needs to be enclosed in double-quotes (").

[staging]
    scheme = sftp
    user = example
    ; When connecting via SFTP, you can opt for password-based authentication:
    pass = password
    ; Or private key-based authentication:
    privkey = 'path/to/or/contents/of/privatekey'
    host = staging-example.com
    path = /path/to/installation
    port = 22
    ; You can specify a branch to deploy from
    branch = develop
    ; File permission set on the uploaded files/directories
    permissions = 0700
    ; File permissions set on newly created directories
    directoryPerm = 0775
    ; Deploy only this directory as base directory
    base = 'directory-name/'
    ; Files that should be ignored and not uploaded to your server, but still tracked in your repository
    exclude[] = 'src/*.scss'
    exclude[] = '*.ini'
    ; Files that are ignored by Git, but you want to send the the server
    include[] = 'js/scripts.min.js'
    include[] = 'directory-name/'
    ; conditional include - if source file has changed, inclue file
    include[] = 'css/style.min.css:src/style.css' 
    ; Directories that should be copied after deploy, from->to
    copy[] = 'public->www'
    ; Directories that should be purged before deploy
    purge-before[] = "dist/"
    ; Directories that should be purged after deploy
    purge[] = "cache/"
    ; Pre- and Post-deploy hooks
    ; Use "DQOUTE" inside your double-quoted strings to insert a literal double quote
    ; Use 'QUOTE' inside your qouted strings to insert a literal quote
    ; For example pre-deploy[] = 'echo "that'QUOTE's nice"' to get a literal "that's".
    ; That workaround is based on http://php.net/manual/de/function.parse-ini-file.php#70847
    pre-deploy[] = "wget http://staging-example.com/pre-deploy/test.php --spider --quiet"
    post-deploy[] = "wget http://staging-example.com/post-deploy/test.php --spider --quiet"
    ; Works only via SSH2 connection
    pre-deploy-remote[] = "touch .maintenance"
    post-deploy-remote[] = "mv cache cache2"
    post-deploy-remote[] = "rm .maintenance"
    ; You can specify a timeout for the underlying connection which might be useful for long running remote 
    ; operations (cache clear, dependency update, etc.)
    timeout = 60

[production]
    quickmode = ftp://example:password@production-example.com:21/path/to/installation
    passive = true
    ssl = false
    ; You can specify a branch to deploy from
    branch = master
    ; File permission set on the uploaded files/directories
    permissions = 0774
    ; File permissions set on newly created directories
    directoryPerm = 0755
    ; Files that should be ignored and not uploaded to your server, but still tracked in your repository
    exclude[] = 'libs/*'
    exclude[] = 'config/*'
    exclude[] = 'src/*.scss'
    ; Files that are ignored by Git, but you want to send the the server
    include[] = 'js/scripts.min.js'
    include[] = 'js/style.min.css'
    include[] = 'directory-name/'
    purge-before[] = "dist/" 
    purge[] = "cache/" 
    pre-deploy[] = "wget http://staging-example.com/pre-deploy/test.php --spider --quiet"
    post-deploy[] = "wget http://staging-example.com/post-deploy/test.php --spider --quiet"

If your password is missing in the phploy.ini file or the PHPLOY_PASS environment variable, PHPloy will interactively ask you for your password.
There is also an option to store the user and password in a file called .phploy.

[staging]
    user="theUser"
    pass="thePassword"

[production]
    user="theUser"
    pass="thePassword"

This feature is especially useful if you would like to share your phploy.ini via Git but hide your password from the public.

You can also use environment variables to deploy without storing your credentials in a file.
These variables will be used if they do not exist in the phploy.ini file:

PHPLOY_HOST
PHPLOY_PORT
PHPLOY_PASS
PHPLOY_PATH
PHPLOY_USER
PHPLOY_PRIVKEY

These variables can be used like this;

$ PHPLOY_PORT="21" PHPLOY_HOST="myftphost.com" PHPLOY_USER="ftp" PHPLOY_PASS="ftp-password" PHPLOY_PATH="/home/user/public_html/example.com" phploy -s servername

Or export them like this, the script will automatically use them:

$ export PHPLOY_PORT="21"
$ export PHPLOY_HOST="myftphost.com"
$ export PHPLOY_USER="ftp"
$ export PHPLOY_PASS="ftp-password"
$ export PHPLOY_PATH="/home/user/public_html/example.com"
$ export PHPLOY_PRIVKEY="path/to/or/contents/of/privatekey"
$ phploy -s servername

Multiple servers

PHPloy allows you to configure multiple servers in the deploy file and deploy to any of them with ease.

By default PHPloy will deploy to ALL specified servers. Alternatively, if an entry named 'default' exists in your server configuration, PHPloy will default to that server configuration. To specify one single server, run:

phploy -s servername

or:

phploy --server servername

servername stands for the name you have given to the server in the phploy.ini configuration file.

If you have a 'default' server configured, you can specify to deploy to all configured servers by running:

phploy --all

Shared configuration (custom defaults)

If you specify a server configuration named *, all options configured in this section will be shared with other
servers. This basically allows you to inject custom default values.

; The special '*' configuration is shared between all other configurations (think include)
[*]
    exclude[] = 'src/*'
    include[] = "dist/app.css"

; As a result both shard1 and shard2 will have the same exclude[] and include[] "default" values
[shard1]
    quickmode = ftp://example:password@shard1-example.com:21/path/to/installation

[shard2]
    quickmode = ftp://example:password@shard2-example.com:21/path/to/installation

Rollbacks

Warning: the --rollback option does not currently update your submodules correctly.

PHPloy allows you to roll back to an earlier version when you need to. Rolling back is very easy.

To roll back to the previous commit, you just run:

phploy --rollback

To roll back to whatever commit you want, you run:

phploy --rollback commit-hash-goes-here

When you run a rollback, the files in your working copy will revert temporarily to the version of the rollback you are deploying. When the deployment has finished, everything will go back as it was.

Note that there is not a short version of --rollback.

Listing changed files

PHPloy allows you to see what files are going to be uploaded/deleted before you actually push them. Just run:

phploy -l

Or:

phploy --list

Updating or "syncing" the remote revision

If you want to update the .revision file on the server to match your current local revision, run:

phploy --sync

If you want to set it to a previous commit revision, just specify the revision like this:

phploy --sync your-revision-hash-here

Creating deployment directory on first deploy

If the deployment directory does not exits, you can instruct PHPloy to create it for you:

phploy --force

Manual fresh upload

If you want to do a fresh upload, even if you have deployed earlier, use the --fresh argument like this:

phploy --fresh

Submodules

Submodules are supported, but are turned off by default since you don't expect them to change very often and you only update them once in a while. To run a deployment with submodule scanning, add the --submodules parameter to the command:

phploy --submodules

Purging

In many cases, we need to purge the contents of a directory after a deployment. This can be achieved by specifying the directories in phploy.ini like this:

; relative to the deployment path
purge[] = "cache/"

To purge a directory before deployment, specify the directories in phploy.ini like this:

; relative to the deployment path
purge-before[] = "dist/"

Hooks

PHPloy allows you to execute commands before and after the deployment. For example you can use wget call a script on my server to execute a composer update.

; To execute before deployment
pre-deploy[] = "wget http://staging-example.com/pre-deploy/test.php --spider --quiet"
; To execute after deployment
post-deploy[] = "wget http://staging-example.com/post-deploy/test.php --spider --quiet"

Logging

PHPloy supports simple logging of the activity. Logging is saved in a phploy.log file in your project in the following format:

2016-03-28 08:12:37+02:00 --- INFO: [SHA: 59a387c26641f731df6f0d1098aaa86cd55f4382] Deployment to server: "default" from branch "master". 2 files uploaded; 0 files deleted.

To turn logging on, add this to phploy.ini:

[production]

    logger = on

Contribute

Contributions are very welcome; PHPloy is great because of the contributors. Please check out the issues.

Credits

Version history

Please check release history for details.

License

PHPloy is licensed under the MIT License (MIT).

Promote Your Next Startup

Alexandre Freire — Sat, 14 Aug 2021 15:54:59 +0000

By https://github.com/trekhleb/promote-your-next-startup

Promote Your Next Startup

Free web-resources you may want to use to promote your next startup.

The main advertisement channel is of course people who are in love with your product.
Their sharing activities is the best advertisement. Thus, the main idea is to
create the product that is useful, usable and attractive to the end users. And only
after that it does make sense to spread the word about something you've done.

Post News

Link	About
reddit.com	The front-page of the internet
news.ycombinator.com	Hacker news
lobste.rs	Lobsters
facebook.com	Post news to your niche groups
twitter.com	Of course
slashdot.org	News for nerds
raddle.me	News feed
designernews.co	Designer news
datatau.net	DataTau - Data Science Newsboard
devrant.com	A fun community of developers
sidebar.io	The five best design links, every weekday

Create a Product Page

Link	About
producthunt.com	The best new products in tech
angel.co	Where the world meets startups
alternativeto.net	Crowd-sourced software recommendations
indiehackers.com	Indie Hackers

Post an Article

Link	About
medium.com	Read, write and share stories that matter
linkedin.com	People and companies that are posting and looking for job. Post to your niche groups as well.
dev.to	The DEV community
dzone.com	Programming news, tutorials and tools
scotch.io	Top shelf web-development training
habr.com	Russian tech-blog
hashnode.com	The Dev community
dou.ua	Ukrainian developers community
muckrack.com	MuckRack for journalist and public relations
techhype.io	News, articles and tools for developers
towardsdatascience.com	Towards Data Science
python.libhunt.com	Awesome Python LibHunt
vas3k.club	Вастрик.Клуб
codementor.io	CodeMentor Community
kdnuggets.com	KDNuggets
morioh.com	Social network for programmers and developers
hackernoon.com	Hacker Noon
blogger.com	Blogging platform
hackr.io	The list of programming classes and tutorials

Niche Platforms

Here are some niche blogs which you may use to find your target audience.

Link	About
geeksforgeeks.org	A computer science portal for geeks
codeforces.com	Programming contests platform
kaggle.com	Your home for datascience

Write for News Blog

Link	About
medium.com/dailyjs	Daily JS news
itnext.io	IT blog
alistapart.com	For people who make web-sites
thenextweb.com	Web news
developer-tech.com	Developer tech news
programmableweb.com	APIs, mashups and the Web as a platform
hakin9.com	Blog of IT security magazine
datacamp.com	Data Science Online News
echojs.com	JavaScript News
css-tricks.com	CSS Tricks

Answer Questions

Link	About
stackoverflow.com	Where developers learn, share and build careers
quora.com	A place to share knowledge and better understand the world

Write on Forums

Link	About
techrepublic.com	Community of IT experts
sitepoint.com	Sitepoint forums

Write to Dev-Chats

Don't spam!

If you think your project is useful for some specific group of people
then find targeted channel, read about channel rules and only then post information
to channel.

Link	About
gitter.im	Where developers come to talk

Record a video

Record a demo video of your product, or some learning content and upload it to your YouTube channel. Put the link to the product or to the content to the video description.

Link	About
youtube.com	Video platform

Become Awesome

If you find your project to be related to one of the awesome partitions then just
go ahead and create pull request to add your product to the list.

Link	About
github.com/bayandin/awesome-awesomeness	A curated list of awesome awesomeness

Use Advanced Google Search Techniques

Google supports powerful search techniques that may help you to promote your resource.

Find sites linking to competitors

Find sites linking to your competitors and try to add your link to that web-sites as well.

Google’s link: operator was officially deprecated in 2017. But it does still return some results.

It might be a good idea to exclude competitor web-site itself from the search results by using the site: operator to avoid displaying of internal links

Do the following Google search but with you competitor's URL:

link:https://competitor-domain.com/blog -site:competitor-domain.com

Find guest post opportunities

This allows you to find web-sites where you might submit the article about your new project/product/startup.

Pick your niche keyword (i.e. programming) and Google search for guest post related phrases like so:

programming intitle:"write for us" inurl:"write-for-us"

You can also use other phrases like:

contribute to
become a contributor
guest post guidelines
inurl:guest-post
etc.

You can also search for many of these at once:

programming ("write for us" | inurl:"guest-post-guidelines" | inurl:"guest-post")

Or even:

(programming | machine learning) AND ("write for us" | inurl:"guest-post-guidelines")

Find resource page opportunities

Resource pages contains the links to best resources on specific topic.

It might be a good idea to pitch your resource for inclusion.

To find resource pages you might do the following Google search:

programming (intitle:"resources" | inurl:resources)

Or you might narrow it down to:

intitle:programming AND intitle:resources AND inurl:resources

Find more related resource

Once you found a good web-site to place a link to you might want to find similar relevant resources.

To do so just do the following Google search but with the resource you're interested in:

related:https://news.ycombinator.com

Register in Startup Directories

Link	About
betalist.com	Discover and get early access to tomorrow's startup
startuptabs.com	Startup discovery engine
crunchbase.com	Discover innovative companies and the people behind them
geekwire.com	Breaking news in technology in business
f6s.com	Startup founder deals and accelerators
killerstartups.com	Where internet entrepreneurs are the stars
startupbuffer.com	Promote your startup and discover new startups
allstartups.info	All startups info
betapage.co	Community of tech lovers and early adopters
index.co	Connecting startups, corporate brands, and investors
gust.com	Startup funding and investing
startupproject.org	The startup project
springwise.com	Discovering innovation
launchlister.com	See the day's hottest product launches
vator.tv	Voice of the entrepreneur
nextbigwhat.com	Discover great products
iamwire.com	A digital incubator & network for technology ecosystem
snapmunk.com	Technology trends and startup culture
nibletz.com	The voice of the startups
startupstash.com	Curated resources and tools for startups
alltopstartups.com	All top startups
startupdope.com	Startup Dope
techpluto.com	Platform to showcase innovative startups and tech news
thestartuppitch.com	Come pitch your startup to the world
sideprojectors.com	Marketplace to buy and sell side projects
launchingnext.com	New startups and ideas
startupranking.com	New startups and ideas

Other suggestions

Use findareddit.com to find relevant subreddits for your niche

Depending on the subject of your post you may use the targeted subreddits: