Comments (10)
It feels like a 3 point semantic version makes the most sense.
Bug fixes in the 3rd point release, e.g. 3.0.1.
Potential braking changes in the second point release, new features, and an opportunity to add further dependencies and increase PHP version in the 2nd point release, e.g. 3.1.0.
And the first point bump could be reserved for major Authy API changes, such as those that may necessarily break the library; say if the API outputs a different format or data or you otherwise want to rewrite/refactor parts of the library.
It likely means more frequent tags/releases but also provides some stability and assurance that people who depend on the library shouldn’t ever accidentally land on a version of the library that breaks their code unexpectedly.
from authy-php.
It works now, but it didn't previously.
It looks like @luisuribe may have seen my comment and updated the entry on Packagist, or something else triggered it to update.
Prior to my comment a few days ago, the dev-master entry was listing de696964a8a8c471d6281cf65301224e4db0e1a0
(the commit prior to mine) as the "Source Reference" but now it is listing 3fa3b3664f838f94331be5749a4d198b2053cc94
(my pull request being merged).
FWIW, I was able to workaround it because you can specify a specific source reference in composer.json in case this ever happens. It can also be useful in the case where you're tracking the dev-master branch and incompatible or undesirable changes are introduced and you wish to use the last-known working version.
"authy/php": "dev-master#3fa3b3664f838f94331be5749a4d198b2053cc94"
It's even plausible that me pulling down the branch at that specific commit triggered a Packagist sync. Who knows?
All sorted for now, but certainly these are all perfect examples as to why regular releases make things a lot easier 🙂
from authy-php.
So, I did a v.3.0.4 release with the latest master code. Hope this works for your. For new releases we'll be using gitflow.
Thanks for your help and comments. Also sorry for the delay in the responses. We'll continue working to improve this library.
from authy-php.
@chrisdeeming Yup. I need to check the hook for the new releases. Meanwhile, packagist is already synced with the new version. Thanks!
from authy-php.
That's a valid concern. We haven't decided a versioning schema and/or change logs so far. We could start a discussion here and find an agreement.
from authy-php.
Please proceed with the release as the locale is something that has been added recently but has not been released. The semantic version (x.x.x) is accepted and almost considered standardised nowadays. It is used in most of the projects on github. Have a look on these:
For anyone wanting to test their code with the master branch you can try to include "authy/php": "dev-master"
in your composer file. Beware though, you will need to specify a normal version as soon as it is available or you might have issues as soon as new commits are introduced to the master branch.
from authy-php.
Also please avoid making changes to the master branch directly for non-released code. When someone firsts lands on the project, they see a version number of the library and check what it is included on the master branch. Currently the master branch is not synced with the releases. Thus this code should not have been on the master branch. Try to keep the master branch synced with the releases, anything else can be on a develop branch. Take a look at gitflow for a better understanding over this: https://datasift.github.io/gitflow/IntroducingGitFlow.html
from authy-php.
@nmargaritis @luisuribe there's actually another issue that arises related to dev-master
.
Likely because of the explanation here...
composer/packagist#587 (comment)
Packagist is actually out of date:
https://packagist.org/packages/authy/php#dev-master
Note the source reference is the last "proper" commit, rather than the merging of the pull request I submitted.
So I'm actually in a situation where I can't (easily) use the updates that are now part of the package because a) Packagist didn't update and b) there hasn't been an explicit release.
@luisuribe I think it's possible for you to log in to Packagist and update the package manually, which would be very helpful. Otherwise, I'll have to wait until a release is made.
Many thanks,
Chris
from authy-php.
@nmargaritis @luisuribe there's actually another issue that arises related to
dev-master
.Likely because of the explanation here...
composer/packagist#587 (comment)Packagist is actually out of date:
https://packagist.org/packages/authy/php#dev-masterNote the source reference is the last "proper" commit, rather than the merging of the pull request I submitted.
So I'm actually in a situation where I can't (easily) use the updates that are now part of the package because a) Packagist didn't update and b) there hasn't been an explicit release.
@luisuribe I think it's possible for you to log in to Packagist and update the package manually, which would be very helpful. Otherwise, I'll have to wait until a release is made.
Many thanks,
Chris
Hey Chris, I am able to install the latest changes using the dev-master dependency in composer json.
Are you sure you have tried this?
composer require authy/php dev-master
. However, using dev-master should be used with caution. Every deploy might install different code, based on what is in the master branch.
P.s - Also please inform us what is going to happen with the releases. It has been 10 days since this issue was brought up. If you are not planning to do anything with the project then we will probably have to fork it and fix the issues so that we can use it.
from authy-php.
Thanks for this @luisuribe
I've noticed again (and mentioned it above) that when changes are made in this repo, they don't get cascaded down to Packagist.
Note here the absence of the new version 3.0.4:
https://packagist.org/packages/authy/php
I suspect you don't have the GitHub hook set up, there are details about that here:
https://packagist.org/about#how-to-update-packages
WIthout that, Packagist will only crawl this repo once a week.
from authy-php.
Related Issues (20)
- Guzzle http HOT 1
- Update the docs HOT 3
- Guzzle Version HOT 4
- One touch verification endpoints HOT 3
- Update phpunit to 6+ HOT 1
- $opts parameter is not merged with $params in verifyToken HOT 1
- How can I remove user using API? HOT 1
- Why was locale removed as parameter on /phones/verification/start ? HOT 2
- Unable to Change Locale. (SMS Language) HOT 2
- verifyToken received by requestSms fails after update to v3.0 HOT 7
- Support errors and status codes as stated on Twilio API HOT 2
- Conflict in dependancies with spring boot 2.0.5 HOT 1
- how to obtain authy-id after creating a user HOT 1
- Is this dead? HOT 1
- error 500 in WordPress HOT 1
- License is missing
- Upgrade to Guzzle 7.x HOT 6
- QR Code method missing from 4.x release HOT 3
- Support for php 8.1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from authy-php.